---
title: "Update a team"
method: PATCH
path: "/v2/teams"
tags: ["team"]
---

# Update a team

`PATCH /v2/teams`

This endpoint updates the details of a team specified by the team_id. It allows modification of various team attributes such as the team name, ompany details, phone number, website URL, address, and more.

## Request body

- V2UpdateTeamRequest
  - `team` Authv2UpdateTeam, required
    - `id` string, required — The unique identifier of the team.
    - `name` string — The name of the team.
    - `namespaceId` string — The unique identifier of the namespace.
    - `companyName` string — The name of the company to which the team belongs.
    - `companyWebsite` string — The URL of the company's website.
    - `companyPhone` string — The phone number of the company to which the team belongs.
    - `companyAddress` Authv2CompanyAddress
      - `addressLine` string — The primary address line, typically including the street address.
      - `postcode` string — The postal code for the address.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
    - `industryType` 'INDUSTRY_TYPE_GROCERY' | 'INDUSTRY_TYPE_PHARMACEUTICALS' | 'INDUSTRY_TYPE_PET_SUPPLIES' | 'INDUSTRY_TYPE_LIQUOR' | 'INDUSTRY_TYPE_ELECTRONICS' | 'INDUSTRY_TYPE_HARDWARE' | 'INDUSTRY_TYPE_FASHION' | 'INDUSTRY_TYPE_OTHER'
    - `businessIdentifier` string — A unique identifier used for various business-related purposes, such as a registration number, business license, or company house number. The specific identifier required may vary depending on the country or region where your company is located.
    - `reviewerEmail` string — The email address to be notified when a campaign requires review or when there is information about a low wallet balance. This field is applicable only to the Primary Retailer team..
    - `logoId` string — A unique identifier for the logo associated with the team.
    - `sellerId` string — A unique identifier for a supplier or merchant, issued by a Retailer. Ensure that the entered ID matches the one provided by your retailer.
    - `modifyTime` string, date-time — The timestamp indicating when the team was last modified.
    - `onBehalfOf` string — Specifies the entity responsible for funding advertisements, as required by local laws, such as the Digital Services Act in Europe.

## Response `200`

The updated team.

- V2UpdateTeamResponse
  - `team` Authv2UpdateTeamResp
    - `id` string — The unique identifier of the team.
    - `name` string — The name of the team.
    - `namespaceId` string — The unique identifier of the namespace.
    - `companyName` string — The name of the company to which the team belongs.
    - `companyWebsite` string — The URL of the company's website.
    - `companyPhone` string — The phone number of the company to which the team belongs.
    - `companyAddress` V2CompanyAddress
      - `addressLine` string — The primary address line, typically including the street address.
      - `postcode` string — The postal code for the address.
    - `companyType` 'COMPANY_TYPE_RETAILER' | 'COMPANY_TYPE_MANUFACTURER'
    - `industryType` 'INDUSTRY_TYPE_GROCERY' | 'INDUSTRY_TYPE_PHARMACEUTICALS' | 'INDUSTRY_TYPE_PET_SUPPLIES' | 'INDUSTRY_TYPE_LIQUOR' | 'INDUSTRY_TYPE_ELECTRONICS' | 'INDUSTRY_TYPE_HARDWARE' | 'INDUSTRY_TYPE_FASHION' | 'INDUSTRY_TYPE_OTHER'
    - `businessIdentifier` string — A unique identifier used for various business-related purposes, such as a registration number, business license, or company house number. The specific identifier required may vary depending on the country or region where your company is located.
    - `reviewerEmail` string — The email address to be notified when a campaign requires review or when there is information about a low wallet balance. This field is applicable only to the Primary Retailer team..
    - `logoId` string — A unique identifier for the logo associated with the team.
    - `sellerId` string — A unique identifier for a supplier or merchant, issued by a Retailer. Ensure that the entered ID matches the one provided by your retailer.
    - `modifyTime` string, date-time — The timestamp indicating when the team was last modified.
    - `onBehalfOf` string — Specifies the entity responsible for funding advertisements, as required by local laws, such as the Digital Services Act in Europe.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/versions/a040003c7378/schema)