# 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*, and *Tone of Voice*—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-capabilities/ai-brand-management-rest-api/brand-kit/create_brand_kit_api_brands_v1_organizations__organizationid__brandkits_post.md): Creates a new brand kit for an organization. The created brand kit includes predefined sections like , , , and more, which are empty by default.
 
 In the response, the  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-capabilities/ai-brand-management-rest-api/brand-kit/list_brand_kits_api_brands_v1_organizations__organizationid__brandkits_get.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-capabilities/ai-brand-management-rest-api/brand-kit/get_brand_kit_api_brands_v1_organizations__organizationid__brandkits__brandkitid__get.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-capabilities/ai-brand-management-rest-api/brand-kit/list_brand_kit_sections_api_brands_v1_organizations__organizationid__brandkits__brandkitid__sections_get.md): Retrieves a list of sections in a brand kit. Each section contains information that define the brand's identity and guidelines, such as , , and .

 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-capabilities/ai-brand-management-rest-api/brand-kit/create_brand_kit_section_field_api_brands_v2_organizations__organizationid__brandkits__brandkitid__sections__sectionid__fields_post.md): Creates a custom brand kit subsection. 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  section has default subsections has subsections to define the brand's purpose, history, and more. To add a new subsection for , you can use this endpoint to create it.

## List brand kit subsections

 - [GET /api/brands/v2/organizations/{organizationId}/brandkits/{brandkitId}/sections/{sectionId}/fields](https://api-docs.sitecore.com/ai-capabilities/ai-brand-management-rest-api/brand-kit/list_brand_kit_section_fields_api_brands_v2_organizations__organizationid__brandkits__brandkitid__sections__sectionid__fields_get.md): Retrieves a list of subsections in a specific brand kit section. Each subsection contains guidelines that define that section's content. For example, the  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-capabilities/ai-brand-management-rest-api/brand-kit/update_brand_kit_section_field_api_brands_v2_organizations__organizationid__brandkits__brandkitid__sections__sectionid__fields__fieldid__patch.md): Partially updates a specific subsection in a brand kit.

 A brand kit includes default sections such as , , and . Each section contains predefined subsections that reflect your brand guidelines.

 Use this endpoint to update a subsection’s properties, such as intent, content, and AI editability.