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

Create a brand kit subsection

Request

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. 

{
  "name": "Product",
  "type": "array",
  "order": 0,
  "value": [{"locale": "fr-FR", "term": "Produit"}, {"locale": "es-ES", "term": "Producto"}],
  "deletable": false,
  "verified": true,
  "aiEditable": true,
  "createdBy": "string",
  "properties": {
    "sourceLanguage": "en-US" 
  }
}

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. 

{
  "name": "CompanyName",
  "type": "array",
  "order": 0,
  "value": [],
  "intent": "Mark a term as not to be translated",
  "deletable": false,
  "verified": true,
  "aiEditable": true,
  "createdBy": "string",
  "properties": {
    "sourceLanguage": "en-US" 
  }
}

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

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
brandkitIdstring(Brandkitid)required

The unique identifier of your brand kit.

To get this value, use the List brand kits endpoint to return the id of each brand kit in your organization. This is the same id returned when you create a brand kit using the Create a brand kit endpoint.

Alternatively, you can open your brand kit in Stream. In the Sitecore Cloud Portal URL, brandkitId comes after brandkits/.

Example:d2c2df7a-1137-43dd-bba3-73ec313526b1
sectionIdstring(Sectionid)required

The unique identifier of your brand kit section.

To get this value, use the List brand kit sections endpoint. The id in the response is the section ID.

Example:37a49437-e1c8-4697-b1c2-914e2382ea75
Bodyapplication/jsonrequired
namestring(Name)required

The name of the subsection to be created.

Example:"Localization and cultural sensitivity"
typestring(BrandKitSectionFieldType)required

The type of brand kit subsection.

Enum:"text""array""richArray"
Example:"text"
orderinteger or null(Order)
Example:1
Any of:

The position of the subsection within the brand kit section. For example, in the Global Goals section, the order is 1 for the Digital mandatories subsection.

integer
valuestring or object or Array of any or null(Value)
Example:"Essential requirements for adapting digital content to diverse linguistic, cultural, and regional contexts."
Any of:

The value or content of the created subsection.

string
intentstring or null(Intent)
Example:"The core reason for the brand existence."
Any of:

The intent or prompt that instructs the AI in populating this subsection and retrieving information from existing brand knowledge based on uploaded brand documents.

string
referencesArray of objects or null(References)
Any of:

An array of references associated with the brand kit subsection.

deletableboolean or null(Deletable)
Example:true
Any of:

Whether the subsection can be deleted.

boolean
verifiedboolean or null(Verified)
Example:true
Any of:

Whether the subsection's content has been verified by the user.

boolean
aiEditableboolean or null(Aieditable)
Example:true
Any of:

Whether the subsection can be edited by AI. If set to true, the AI will overwrite the subsection's content value when brand documents are reprocessed.

boolean
createdBystring or null(Createdby)
Example:"mman"
Any of:

The user who created the subsection.

string
propertiesobject or null(Properties)
Any of:

Additional properties for the subsection.

curl -i -X POST \
  https://edge-platform.sitecorecloud.io/ai/ai-brands-api/api/brands/v2/organizations/org_ABCDef123456/brandkits/d2c2df7a-1137-43dd-bba3-73ec313526b1/sections/37a49437-e1c8-4697-b1c2-914e2382ea75/fields \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Localization and cultural sensitivity",
    "type": "text",
    "order": 1,
    "value": "Essential requirements for adapting digital content to diverse linguistic, cultural, and regional contexts.",
    "intent": "The core reason for the brand existence.",
    "references": [
      {
        "id": "2ad5c154-6404-49ed-9ffc-0603c360a5af",
        "path": "/path",
        "type": "documentChunk"
      }
    ],
    "deletable": true,
    "verified": true,
    "aiEditable": true,
    "createdBy": "mman",
    "properties": {}
  }'

Responses

Brand kit subsection created successfully

Bodyapplication/json
idstring(Id)required

The unique identifier for the created brand kit subsection.

Example:"b2f2e1a1-295d-4d40-88f2-93bf545bb879"
namestring(Name)required

The name of the subsection.

Example:"Localization and cultural sensitivity"
typestring(BrandKitSectionFieldType)required

The type of brand kit subsection.

Enum:"text""array""richArray"
Example:"text"
orderinteger or null(Order)
Example:1
Any of:

The order the subsection appears in the brand kit section. For example, if it is the first subsection, order is 1.

integer
valuestring or object or Array of any or null(Value)
Example:"Essential requirements for adapting digital content to diverse linguistic, cultural, and regional contexts."
Any of:

The value or content of the created subsection.

string
intentstring or null(Intent)
Example:"The core reason for the brand existence."
Any of:

The intent or prompt that instructs the AI in populating this subsection and retrieving information from existing brand knowledge based on uploaded brand documents.

string
referencesArray of objects or null(References)
Any of:

The brand documents the AI referenced to generate content for this subsection.

deletableboolean or null(Deletable)
Example:true
Any of:

Whether the subsection can be deleted.

boolean
verifiedboolean or null(Verified)
Example:true
Any of:

Whether the subsection's content has been verified by the user.

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

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

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

The user who created the subsection

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

The date and time when the subsection was updated, formatted in ISO 8601.

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

The user who last updated the subsection.

string
aiEditableboolean or null(Aieditable)
Example:true
Any of:

Whether the subsection can be edited by AI. If set to true, the AI will overwrite the subsection's content value when brand documents are reprocessed.

boolean
propertiesobject or null(Properties)
Any of:

Additional properties for the subsection.

Response
{
  "id": "b2f2e1a1-295d-4d40-88f2-93bf545bb879",
  "name": "Localization and cultural sensitivity",
  "type": "text",
  "order": 1,
  "value": "Essential requirements for adapting digital content to diverse linguistic, cultural, and regional contexts.",
  "intent": "The core reason for the brand existence.",
  "references": [
    { … }
  ],
  "deletable": true,
  "verified": true,
  "createdOn": "2025-06-18T12:46:12.718310Z",
  "createdBy": "mman",
  "updatedOn": "2025-06-18T12:46:12.718310Z",
  "updatedBy": "mman",
  "aiEditable": true,
  "properties": {}
}