---
title: "Submit a brand"
method: POST
path: "/v1/projects/{projectId}/brands/{brandId}:submit"
tags: ["brands"]
---

# Submit a brand

`POST /v1/projects/{projectId}/brands/{brandId}:submit`

The endpoint submit the brand for validation. The brand must be in DRAFT or INCOMPLETE status. The brand is validated against the brand type format and the status is updated accordingly (PENDING_REVIEW from INCOMPLETE, NEW from DRAFT).

## Path parameters

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

## 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 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)