Partial update of the authenticated brand's theme.

PATCH

/brands/me/theme

• Production
• Staging
• Local dev

Accepts any subset of the theme fields. Omitted fields are left untouched; explicit null clears an override. version is server-managed and bumps by one on every call.

Authorizations

• bearerAuth

Parameters

Header Parameters

X-Polst-Idempotency-Key

required

string

>= 8 characters <= 255 characters

Idempotency key, 8–255 URL-safe chars.

Request Body ^required

object

accent

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

background

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

foreground

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

radius

string

Allowed values: NONE SM MD LG FULL

density

string

Allowed values: COMPACT COMFORTABLE

fontStack

string

Allowed values: SYSTEM SERIF MONO BRAND

fontBrandUrl

Any of:

string

string

<= 2048 characters

null

null

logoLightUrl

Any of:

string

string

<= 2048 characters

null

null

logoDarkUrl

Any of:

string

string

<= 2048 characters

null

null

faviconUrl

Any of:

string

string

<= 2048 characters

null

null

hideWatermark

boolean

customCss

Any of:

string

string

<= 4096 characters

null

null

titleColor

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

titleSize

Any of:

integer

integer

>= 10 <= 96

null

null

titleWeight

Any of:

integer

integer

>= 100 <= 900

null

null

titlePlacement

Any of:

string

string

Allowed values: ABOVE BELOW HIDDEN

null

null

labelColor

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

labelSize

Any of:

integer

integer

>= 10 <= 72

null

null

labelPlacement

Any of:

string

string

Allowed values: HEADER OVERLAID BELOW HIDDEN

null

null

labelAlign

Any of:

string

string

Allowed values: LEFT CENTER

null

null

headerFill

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeBg

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeFg

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeDiameter

Any of:

integer

integer

>= 24 <= 96

null

null

imageRatio

Any of:

number

number

>= 0.25 <= 4

null

null

elevation

Any of:

string

string

Allowed values: FLAT LIFTED

null

null

Responses

200

Updated theme.

object

data

required

object

accent

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

background

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

foreground

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

radius

required

string

Allowed values: NONE SM MD LG FULL

density

required

string

Allowed values: COMPACT COMFORTABLE

fontStack

required

string

Allowed values: SYSTEM SERIF MONO BRAND

fontBrandUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoLightUrl

required

Any of:

string

string

<= 2048 characters

null

null

logoDarkUrl

required

Any of:

string

string

<= 2048 characters

null

null

faviconUrl

required

Any of:

string

string

<= 2048 characters

null

null

hideWatermark

required

boolean

customCss

required

Any of:

string

string

<= 4096 characters

null

null

version

required

integer

<= 9007199254740991

titleColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

titleSize

required

Any of:

integer

integer

>= 10 <= 96

null

null

titleWeight

required

Any of:

integer

integer

>= 100 <= 900

null

null

titlePlacement

required

string

Allowed values: ABOVE BELOW HIDDEN

labelColor

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

labelSize

required

Any of:

integer

integer

>= 10 <= 72

null

null

labelPlacement

required

string

Allowed values: HEADER OVERLAID BELOW HIDDEN

labelAlign

required

string

Allowed values: LEFT CENTER

headerFill

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeBg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeFg

required

Any of:

string

string

/^#([0-9a-f]{6}|[0-9a-f]{8})$/

null

null

orBadgeDiameter

required

Any of:

integer

integer

>= 24 <= 96

null

null

imageRatio

required

Any of:

number

number

>= 0.25 <= 4

null

null

elevation

required

string

Allowed values: FLAT LIFTED

400

Missing idempotency key.

401

Missing or invalid bearer token.

403

Bearer token lacks manage scope or brand context.

422

Request body failed validation. customCss is rejected if it contains ’<’ or ’>’ characters or does not parse as a CSS stylesheet.