Sitecore API catalog/Brand Management API/
/
Create a brand kit

Create a brand kit

Request

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.

Security
HTTPBearer
Path
organizationIdstring(Organizationid)required

The unique identifier of your organization.

To get this value, in the Sitecore Cloud Portal URL, the organizationId comes after organization=.

Example:org_ABCDef123456
Bodyapplication/jsonrequired
namestring(Name)required

The name of the brand kit.

Example:"Powerful EU brand kit"
descriptionstring or null(Description)
Example:"Brand kit for the Powerful energy bars EU market."
Any of:

A brief description of the brand kit.

string
industrystring or null(Industry)
Example:"retail"
Any of:

The industry this brand kit is associated with.

string
brandNamestring or null(Brandname)
Example:"Powerful"
Any of:

The name of the brand associated with this brand kit.

string
companyNamestring or null(Companyname)
Example:"Powerful Europe Ltd."
Any of:

The name of the company if different from the brand name.

string
curl -i -X POST \
  https://edge-platform.sitecorecloud.io/ai/ai-brands-api/api/brands/v1/organizations/org_ABCDef123456/brandkits \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Powerful EU brand kit",
    "description": "Brand kit for the Powerful energy bars EU market.",
    "industry": "retail",
    "brandName": "Powerful",
    "companyName": "Powerful Europe Ltd.",
    "logo": "https://example.com/logo.png"
  }'

Responses

Brand kit created successfully

Bodyapplication/json
organizationIdstring(Organizationid)required

The unique identifier of your organization.

Example:"org_ABCDef123456"
idstring(Id)required

The unique identifier of the brand kit.

Example:"a1234bcd-efg5-678h-910i-jklmnopqrstu"
namestring(Name)required

The name of the brand kit.

Example:"Powerful EU brand kit"
descriptionstring or null(Description)
Example:"Brand kit for the Powerful energy bars EU market."
Any of:

A brief description of the brand kit.

string
brandNamestring or null(Brandname)
Example:"Powerful"
Any of:

The name of the brand associated with this brand kit.

string
companyNamestring or null(Companyname)
Example:"Powerful Europe Ltd."
Any of:

The name of the company if different from the brand name.

string
statusBrandKitStatus (string) or null
Any of:

The current status of the brand kit.

string(BrandKitStatus)
Enum:"draft""inprocess""published""failed"
parentIdstring or null(Parentid)
Example:"a1234bcd-efg5-678h-910i-abcdefghijklmn"
Any of:

The parent brand kit ID. Used when AI creates a new version of the brand kit during brand ingestion to indicate the original brand kit it's based on.

string
parentTypeParentTypeEnum (string) or null
Example:"brandkit"
Any of:

The type of the parent entity that the tags are associated with. This can be used to categorize tags based on the specific entity they are linked to, such as a brand kit, section, or subsection.

string(ParentTypeEnum)
Enum:"brandkit"""
industrystring or null(Industry)
Example:"retail"
Any of:

The industry this brand kit is associated with.

string
tagsArray of objects or null(Tags)
Example:
[]
Any of:

An array of tags associated with the brand kit to categorize its documents.

referencesArray of objects or null(References)
Example:
[]
Any of:

An array of references associated with the brand kit.

createdOnstring or null(Createdon)
Example:"2025-06-18T12:46:12.718310Z"
Any of:

The date and time when the brand kit was created, formatted in ISO 8601.

string (date-time)
createdBystring or null(Createdby)
Example:"mman"
Any of:

The user who created the brand kit.

string
updatedOnstring or null(Updatedon)
Example:"2025-06-18T12:46:12.718310Z"
Any of:

The date and time when the brand kit was last updated, formatted in ISO 8601.

string (date-time)
updatedBystring or null(Updatedby)
Example:"mman"
Any of:

The user who last updated the brand kit, formatted in ISO 8601.

string
Response
{
  "organizationId": "org_ABCDef123456",
  "id": "a1234bcd-efg5-678h-910i-jklmnopqrstu",
  "description": "Brand kit for the Powerful energy bars EU market.",
  "name": "Powerful EU brand kit",
  "brandName": "Powerful",
  "companyName": "Powerful Europe Ltd.",
  "logo": "https://example.com/logo.png",
  "status": "draft",
  "parentId": "a1234bcd-efg5-678h-910i-abcdefghijklmn",
  "parentType": "brandkit",
  "industry": "retail",
  "tags": [],
  "references": [],
  "createdOn": "2025-06-18T12:46:12.718310Z",
  "createdBy": "mman",
  "updatedOn": "2025-06-18T12:46:12.718310Z",
  "updatedBy": "mman"
}