Notify the server that a presigned PUT has completed; runs processing, patches the matching theme URL column, and enqueues cleanup of any prior asset keys.

POST

/brands/me/theme/assets/processed

• Production
• Staging
• Local dev

Call this after the client has PUT the bytes to the uploadUrl from /assets/upload-url. The server downloads the object, sanitises / resizes / composites derivatives, uploads them under sibling keys, and atomically PATCHes the corresponding BrandTheme URL column (and logoDarkUrl when auto-generating a dark variant). Response is the updated theme DTO.

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

slot

required

string

Allowed values: logo_light logo_dark favicon

key

required

string

>= 1 characters

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.

404

Uploaded S3 object not found.

422

Request body failed validation.