V1 / Brands / Index

Create a brand

Create a brand in the current space. Session-authenticated (dashboard login; owner/admin/editor). External image URLs inside tokens are re-uploaded to your space. For API-key access use the MCP server (create_brand).

POST/api/v1/brands/index

Request body

PropertyTypeRequiredDescription
namestringYesBrand name
draftTokensobjectNoToken kit being edited (logos, colors, typography, …)
liveTokensobjectNoToken kit used by published renders
tokensobjectNoResolved token set
variantsobjectNoNamed variations of the kit
extraobjectNoFree-form extras

Responses

200

JSON { doc } — the created brand

401

Not logged in

Request
curl -X POST "https://bannx.com/api/v1/brands/index" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -d '{"name":"string","draftTokens":null,"liveTokens":null,"tokens":null,"variants":null}'
Response
// JSON { doc } — the created brand
{
  "success": true,
  "data": { ... }
}