# Brand kit

The Brand kit API lets you create and retrieve brand kits within your organization. You can also retrieve or update sections—such as *Brand Context*, *Global Goals*, *Tone of Voice*, and *Glossary and Localization*—and retrieve or create subsections within those sections.

## Create a brand kit

 - [POST /api/brands/v1/organizations/{organizationId}/brandkits](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/create_brand_kit.md): Creates a new brand kit for an organization. The created brand kit includes predefined sections like Brand Context, Global Goals, Tone of Voice, and more, which are empty by default.
 
 In the response, the id key contains the created brand kit's unique identifier.

## List brand kits

 - [GET /api/brands/v1/organizations/{organizationId}/brandkits](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/list_brand_kits.md): Retrieves a list of brand kits in an organization. The response includes basic information about each brand kit, such as its name, description, industry, and status. The response does not include the actual content of the brand kit sections or subsections.

## Retrieve a brand kit

 - [GET /api/brands/v1/organizations/{organizationId}/brandkits/{brandkitId}](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/get_brand_kit.md): Retrieves a specific brand kit by its ID. The response includes basic information about the brand kit, such as its name, description, industry, and status. The response does not include the actual content of the brand kit sections or subsections.

 If you don't know the brand kit ID, you can use the List brand kits endpoint to retrieve the list of brand kits in your organization.

## List brand kit sections

 - [GET /api/brands/v1/organizations/{organizationId}/brandkits/{brandkitId}/sections](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/list_brand_kit_sections.md): Retrieves a list of sections in a brand kit. Each section contains information that define the brand's identity and guidelines, such as Brand Context, Global Goals, and Tone of Voice.

 To return actual content in the sections, the Documents REST API and Pipeline REST API must have already been used to upload and process brand documents for the brand kit.

## Create a brand kit subsection

 - [POST /api/brands/v2/organizations/{organizationId}/brandkits/{brandkitId}/sections/{sectionId}/fields](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/create_brand_kit_section_field.md): Creates a custom brand kit subsection (field). Each brand kit section contains predefined subsections. If a relevant guideline isn’t included by default, you can create a custom subsection to define it. For example, the Brand Context section has default subsections to define the brand's purpose, history, and more. To add a new subsection for Brand Values, you can use this endpoint to create it.

 You can also use this endpoint to manage the terms in the Glossary and Localization section as follows: 

 To add new terms, add a value array. In the following example, product will be translated into French and Spanish. {% code-snippet file="../../ai-skills/code-examples/translate-a-term.json" language="json" /%}

NOTE: To delete a term, use the PATCH endpoint.

To mark a term as not to be translated, use an empty value [ ]. In the following example, CompanyName will not be translated. {% code-snippet file="../../ai-skills/code-examples/do-not-translate.json" language="json" /%}

 NOTE: These examples apply only to the Glossary and Localization section.

## List brand kit subsections

 - [GET /api/brands/v2/organizations/{organizationId}/brandkits/{brandkitId}/sections/{sectionId}/fields](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/list_brand_kit_section_fields.md): Retrieves a list of subsections (fields) in a specific brand kit section. Each subsection contains guidelines that define that section's content. For example, the Brand Context section has subsections to define the brand's purpose, history, and more. 

 To return actual content in the subsections, the Documents REST API and Pipeline REST API must have already been used to upload and process brand documents for the brand kit.

## Partially update a brand kit subsection

 - [PATCH /api/brands/v2/organizations/{organizationId}/brandkits/{brandkitId}/sections/{sectionId}/fields/{fieldId}](https://api-docs.sitecore.com/ai-skills/ai-brand-management-rest-api/brand-kit/update_brand_kit_section_field.md): Partially updates a specific subsection (field) in a brand kit.

 A brand kit includes default sections such as Brand Context, Global Goals, and Tone of Voice. Each section contains predefined subsections that reflect your brand guidelines.

 Use this endpoint to update the properties of a subsection, such as intent, content, and AI editability. You can also use this endpoint to delete locale term values from the Glossary and Localization section.