Skip to main content
POST
Create catalog

Authorizations

Authorization
string
header
required

Bearer token authentication via Auth0. Users authenticate through Auth0 Universal Login. Include the access token in the Authorization header: Authorization: Bearer <token>

Headers

X-Active-Brand
string<uuid>

Active brand ID header (informational; brand_id in body takes precedence).

Path Parameters

workspaceId
string
required

The workspace ID

Pattern: ^ws_[a-z0-9]+$

Body

application/json
name
string
required
Required string length: 1 - 255
brand_id
string<uuid>
required

Brand this catalog belongs to. Required — use BrandSwitcher to select active brand.

description
string | null
Maximum string length: 1000

Response

Catalog created successfully

catalog
object
Last modified on February 16, 2026