---
title: "Update a brand by project and brand id."
method: PUT
path: "/v1/projects/{projectId}/brands/{brandId}"
tags: ["brands"]
---

# Update a brand by project and brand id.

`PUT /v1/projects/{projectId}/brands/{brandId}`

The endpoint receives as path param project id and brand id. If the project and brand exist, the brand is updated. Only NEW and PENDING_REVIEW brands can be updated.

## Path parameters

- `projectId` string, required
- `brandId` string, required

## Request body

- BrandUpdateRequest — Brand Update Request
  - `brandName` string — The name of the brand.
  - `data` BrandCategory[] — The list of categories included in the brand metadata. Each of them includes a list of attributes.
  - `callbackUrl` string, uri — The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.

## Response `200`

OK

- Brand — The brand object that contains the brand details.
  - `brandId` string — The unique identifier for the brand.
  - `brandName` string — The name of the brand.
  - `brandMetadataId` string — The unique identifier for the brand metadata.
  - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
  - `data` BrandCategory[] — The list of categories included in the brand metadata. Each of them includes a list of attributes.
  - `logs` BrandLog[] — The list of logs related to the brand.
    - `status` 'DRAFT' | 'NEW' | 'PENDING' | 'PENDING_REVIEW' | 'REJECTED' | 'INCOMPLETE' | 'COMPLETED' | 'ARCHIVED', enum
    - `createTime` string, date-time — The date and time when the brand status was changed.
    - `comment` string — The message related to the brand status change.
    - `author` 'CUSTOMER' | 'AGENT', enum — Author. It can be either a customer or an agent.
  - `callbackUrl` string — The URL to receive the brand status update callback. The URL must be a valid URL and must be reachable from Sinch.
  - `createTime` string, date-time — The date and time when the brand was created.
  - `updateTime` string, date-time — The date and time when the brand was updated.

## Other responses

- `400` — BAD_REQUEST: Any validation error
- `404` — NOT_FOUND: The project or brand id introduced does not exist.
- `500` — INTERNAL: Internal server error. Typically, a server bug.

---

[API](https://skmtc.net/sinch/apis/sinch-brands-api.md) · [All operations](https://skmtc.net/sinch/apis/sinch-brands-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sinch/sinch-brands-api/revisions/b49d3ae283fd/schema)