chat-themes

Create Chat Theme

Create a new chat theme.

If no identifier is provided, one will be generated from the name.

The configuration blob is normalized + validated on write (the single funnel shared with MCP). It must be a canonical v2 document ({version, branding, defaults}); a legacy-shaped blob (top-level ui/appearance/content/features, or missing branding) or an invalid token (bad hex, non-allowlisted font, bad enum) yields a 400 (RFC 9457) whose detail names the exact offending key. An omitted/empty configuration defaults to the canonical v2 bundle.

post/api/v1/chat-themes

Request

  • Base URL: https://api.gnosari.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gnosari.com/api/v1/chat-themes
  • Auth: one of:
    • HTTP bearer
    • API key in header X-AUTH-TOKEN

Request body

namestring required

Theme name

descriptionstring nullable

Theme description

identifierstring nullable

URL-safe unique identifier

configurationobject

Canonical v2 chat-theme configuration (camelCase blob): {version: 2, branding: {...}, defaults: {...}}. Legacy pre-v2 shapes (top-level ui/content/features/appearance keys) are rejected with a 400.

is_defaultboolean

Whether this is the account's default theme

Response

Successful Response

namestring required

Theme name

descriptionstring nullable

Theme description

identifierstring nullable

URL-safe unique identifier

configurationobject

Canonical v2 chat-theme configuration (camelCase blob): {version: 2, branding: {...}, defaults: {...}}. Legacy pre-v2 shapes (top-level ui/content/features/appearance keys) are rejected with a 400.

is_defaultboolean

Whether this is the account's default theme

idinteger required
created_atstring date-time required
updated_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.