Get inspired at ContentCon Europe. See the agenda and register for free.
Get inspired at ContentCon Europe. See the agenda and register for free.
Contentstack.comAcademyLogin
CS-log-dark.svgCS-log-dark.svg
  • Changelog
  • APIs
  • SDKs

Platform

  • Solution Center
  • Marketplace
  • Changelog
  • Developers & IT
  • Business users
  • Digital leaders
  • Developer Fast Track
  • Plans & Pricing

Solutions

  • Retail
  • Travel and tourism
  • Financial services
  • Technology
  • Manufacturing
  • E-commerce
  • Localization
  • Personalization
  • Portals and knowledge bases

Resources

  • Academy
  • Docs
  • Product updates
  • Contentstack on Contentstack
  • Blog
  • Insights and analyst reports
  • Webinars
  • Podcasts
  • Glossary
  • Content generative library
  • Community
  • Headless CMS
  • Composable AXP
  • Personalization
  • CDP

Customers

  • Case Studies
  • Customer Care
  • Contentstack Experience Awards
  • Customer support

Partners

  • Overview
  • Find a partner
  • Login

Company

  • About us
  • News
  • Customer support portal
  • Contact

Social

  • Facebook
  • LinkedIn
  • Instagram
  • GitHub
  • YouTube
  • Discord
  • X
LegalTermsPrivacyTrust Center

Cookie settings

Copyright © 2026 Contentstack Inc. All rights reserved.
/
  1. Home
  2. APIs
  3. Brand Kit Management API
  4. Brand Kit

Brand Kit

markdownView as Markdown

Brand Kit serves as a centralized repository for your organization's brand identity and guidelines, offering a comprehensive array of product details and overall brand persona. By using the API requests, you can create, view, update, and delete one or more Brand Kits.

Get All Brand Kits

GEThttps://brand-kits-api.contentstack.com/v1/brand-kits?skip={skip}&limit={limit}&include_users={boolean}&include_count={boolean}&include_voice_profiles_count={boolean}&typeahead={string}

The Get All Brand Kits request fetches the list of all the Brand Kits in an organization.

To configure the permissions for your application via OAuth, include the brand-kits:read scope.

Sample Response
Status|200 OK
12345678910111213141516171819
{
  "brand_kits": [
    {
      "uid": "cs***********0",
      "name": "AI Blogs",
      "description": "Brand Kit for AI related Blogs",
      "created_at": "2024-04-26T07:56:35.584Z",
      "created_by": "bl**************b",
      "updated_at": "2024-04-26T08:27:13.974Z",
      "updated_by": "bl**************b",
      "deleted_at": false,
      "api_keys": [
        "bl**************7",
        "bl**************5"
      ],
      "organization_uid": "bl***************9"
    }
  ]
}

Get a Single Brand Kit

GEThttps://brand-kits-api.contentstack.com/v1/brand-kits/{brand_kit_uid}

The Get a Single Brand Kit request fetches the details of a specific Brand Kit in an organization.

To configure the permissions for your application via OAuth, include the brand-kits:read scope.

Sample Response
Status|200 OK
1234567891011121314151617
{
  "brand_kit": {
    "uid": "cs***********40",
    "name": "AI Blogs",
    "description": "Brand Kit for AI related Blogs",
    "created_at": "2024-04-26T07:56:35.584Z",
    "created_by": "bl****************b",
    "updated_at": "2024-04-26T08:27:13.974Z",
    "updated_by": "bl****************b",
    "deleted_at": false,
    "api_keys": [
      "bl*************7",
      "bl*************5"
    ],
    "organization_uid": "bl**************9"
  }
}

Create Brand Kit

POSThttps://brand-kits-api.contentstack.com/v1/brand-kits

The Create Brand Kit request lets you create a new Brand Kit in the specified organization.

To configure the permissions for your application via OAuth, include the brand-kits:manage scope.

Here’s an example of the Request Body for creating a new Brand Kit:

{
"brand_kit": {
"name": "Sample Brand Kit",
"description": "This is a sample Brand Kit created for testing",
"api_keys": [
"bxxxxxxxxxxxx9",
"bxxxxxxxxxxxx9"
]
}
}
Sample Request
123456789
{
  "brand_kit": {
    "name": "Test Brand Kit",
    "description": "Brand Kit for testing",
    "api_keys": [
      "xxxxxxxxxxxx"
    ]
  }
}
Sample Response
Status|201 Created
1234567891011121314151617
{
  "message": "Brand Kit created successfully",
  "brand_kit": {
    "uid": "cs4**********0",
    "name": "Test Brand Kit",
    "description": "Brand Kit for testing",
    "created_at": "2024-05-09T13:17:15.200Z",
    "created_by": "bxxxxxxxxxxxxb",
    "updated_at": "2024-05-09T13:17:15.200Z",
    "updated_by": "bxxxxxxxxxxxxb",
    "deleted_at": false,
    "api_keys": [
      "xxxxxxxxxxxx"
    ],
    "organization_uid": "bxxxxxxxxxxxx9"
  }
}

Update Brand Kit

PUThttps://brand-kits-api.contentstack.com/v1/brand-kits/{brand_kit_uid}

The Update Brand Kit request lets you update an existing Brand Kit in an organization.

To configure the permissions for your application via OAuth, include the brand-kits:manage scope.

Here’s an example of the Request Body that you can use to update a Brand Kit:

{
"brand_kit": {
"name": "Sample Brand Kit",
"description": "This is the updated description for Sample Brand Kit",
"api_keys": [
"bxxxxxxxxxxxx9"
]
}
}
Sample Request
123456789
{
  "brand_kit": {
  	"name": "Sample Brand Kit",
  	"description": "This is the updated description for Sample Brand Kit",
  "api_keys": [
    "b**********9"
  ]
}
}
Sample Response
Status|200 OK
123456789101112131415161718
{
  "message": "Brand Kit updated successfully",
  "brand_kit": {
    "uid": "cs************0",
    "name": "Sample Brand Kit",
    "description": "This is the updated description for Sample Brand Kit",
    "created_at": "2024-05-09T13:17:15.200Z",
    "created_by": "bl**************b",
    "updated_at": "2024-05-09T13:17:15.200Z",
    "updated_by": "bl**************b",
    "deleted_at": false,
    "api_keys": [
      "b**********9",
      "b**********9"
    ],
    "organization_uid": "bl************9"
  }
}

Delete Brand Kit

DELETEhttps://brand-kits-api.contentstack.com/v1/brand-kits/{brand_kit_uid}

The Delete Brand Kit request lets you delete an existing Brand Kit in an organization.

To configure the permissions for your application via OAuth, include the brand-kits:manage scope.

Sample Response
Status|200 OK
123
{
  "message": "Brand Kit deleted successfully"
}
Hide Parameters

Query Parameters

skipoptionalstring

Enter the number of Brand Kits to be skipped from the response body.

Example:

2
limitoptionalstring

Enter the maximum number of Brand Kits to be returned.

Example:

2
include_usersoptionalstring

The “include_users” parameter allows you to fetch users information.

Example:

false
include_countoptionalstring

The “include_count” parameter allows you to fetch the total count of the stacks owned by or shared with a user account.

Example:

false
include_voice_profiles_countoptionalstring

The “include_voice_profiles_count” parameter allows you to fetch the count of all voice profiles from a Brand Kit.

Example:

false
typeaheadoptionalstring

The “typeahead” parameter retrieves responses that match the provided string.

Example:

sample

Headers

organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
api_keyoptionalstring

Enter the API Key of the stack to retrieve the details of Brand Kits specifically associated with it.

Example:

api_key_of_your_stack
authtokenrequiredstring

Enter the authtoken.

Example:

your_authtoken
authorizationrequiredstring

Enter your OAuth token. Learn more about Authentication.

Example:

[Bearer <OAuth token>]
Hide Parameters

URL Parameters

brand_kit_uidrequiredstring

Enter the Brand Kit UID.

Example:

your_brand_kit_uid

Headers

organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
authtokenrequiredstring

Enter the authtoken.

Example:

your_authtoken
authorizationrequiredstring

Enter your OAuth token. Learn more about Authentication.

Example:

[Bearer <OAuth token>]
Hide Parameters

Headers

organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
authtokenrequiredstring

Enter the authtoken.

Example:

your_authtoken
authorizationrequiredstring

Enter your OAuth token. Learn more about Authentication.

Example:

[Bearer <OAuth token>]
Hide Parameters

URL Parameters

brand_kit_uidrequiredstring

Enter the Brand Kit UID.

Example:

your_brand_kit_uid

Headers

organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
authtokenrequiredstring

Enter the authtoken.

Example:

your_authtoken
authorizationrequiredstring

Enter your OAuth token. Learn more about Authentication.

Example:

[Bearer <OAuth token>]
Hide Parameters

URL Parameters

brand_kit_uidrequiredstring

Enter the Brand Kit UID.

Example:

your_brand_kit_uid

Headers

organization_uidrequiredstring

Enter the Organization UID.

Example:

your_organization_uid
authtokenrequiredstring

Enter the authtoken.

Example:

your_authtoken
authorizationrequiredstring

Enter your OAuth token. Learn more about Authentication.

Example:

[Bearer <OAuth token>]