set_brand_kit
Set the brand kit
Set or update the brand kit — the brand definition (logo, colors, font, radius, tone of voice) applied as design defaults to EVERY form in the ACTIVE workspace, existing and future, with no republish. Use this DIRECTLY (no need to list workspaces or forms first) whenever the user wants their forms to match their brand: 'make all my forms look like my brand', 'set up my brand colors', 'use the logo and colors from my website'. If asked to read their website, extract the logo URL and brand color yourself, then call this with colors.primary + logo_url. For one form only, use update_form branding.theme instead. Patches merge — pass only what changes.
One kit per workspace, applied to every form — existing and future — with no republish; a form’s own theme overrides win. Colors are validated for WCAG AA contrast, so an unreadable combination is rejected with a fix suggestion rather than published.
| Parameter | Type | Description |
|---|---|---|
| name | string | Brand display name (may differ from the workspace name) |
| website | string | Brand website (https) |
| logo_url | string | Logo image URL (https) shown on forms |
| colors | object | Brand colors — WCAG-AA contrast is validated |
| colors.primary | string | THE brand color (hex) — accents, focus, progress derive from it |
| colors.background | string | Page background (hex) |
| colors.surface | string | Card/control surface (hex) |
| colors.ink | string | Text color (hex) |
| colors.muted | string | Secondary text (hex; derived when omitted) |
| font | "system" | "humanist" | "geometric" | "rounded" | "serif" | "slab" | "mono" | Typeface character (curated fast system stacks — zero webfont cost) |
| radius | number (min 0, max 24) | Corner radius in px, 0 (sharp) to 24 (round) |
| voice | string | Tone-of-voice notes agents should follow when writing copy for this brand |
* required