POST
Publish a theme as the live theme (spend-class; approval-gated by store policy).

Authorizations

X-Agent-Key
string
header
required

Service-account key, format sq_agt_*. Carries least-privilege scopes.

Headers

Idempotency-Key
string
required

Unique per logical operation; identical key+body returns the cached response, different body → 409.

Maximum string length: 200
X-Store-ID
string

Target store; required when the key is bound to multiple stores.

Path Parameters

theme_id
string
required

Response

A publish of this theme was already queued, waiting for approval or running: that job is returned (existing: true) and no new publish is created.

success
boolean
required
message
string
data
object
meta
object