Skip to navigation

API · BrandKit · Create a new (empty) brand kit (V2)

View as Markdown

Create a new brand kit in the workspace. Only title is required — this makes an empty V2 kit. Populate it afterwards with buildBrandKit (canonical brand/style document) and/or context documents (createContextDocument).

Typical onboarding flow:

  1. createBrandKit with the brand name as title → returns the kit id (UUID)
  2. buildBrandKit with the canonical BrandKitDocument to fill brand + style
  3. getBrandKit?expand=extra to read it back

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
titlestringRequired

Brand name — the only field needed to create a kit.

Response

Brand kit created. Returns the new kit including its id (UUID) for subsequent calls.

Errors

400
Bad Request Error
401
Unauthorized Error