Skip to main content
POST
Create a theme

Authorizations

Authorization
string
header
required

Authorization: Api-Key <application_api_key> (legacy X-Api-Key also accepted).

Body

application/json
name
string
required
Required string length: 1 - 120
company_name
string

Empty string = unset.

Maximum string length: 80
colors
object

Canonical lowercase #rrggbb values only (validated + normalized at write time). Each color is null/omitted when unset.

font_family
enum<string>

Empty string = unset; otherwise the closed allowlist.

Available options:
,
Inter,
system-ui,
Roboto,
Open Sans,
Lato,
Montserrat
status
enum<string>

Create only: draft (default) or active; archived is rejected. PUT rejects it.

Available options:
draft,
active
revision
integer

Replace only: the CAS expectation (or use If-Match).

Response

Created

data
object
required

Workspace-scoped reusable presentation block (replaces the inline workflow branding). Non-PII but an INJECTION SURFACE into the consumer page and invite email, so every field is a closed grammar; logos are managed uploads only (external URLs and SVG are unsupported by design).