Skip to main content
POST
Create Sync Key

Headers

authorization
string | null
X-API-Key
string | null
X-Stella-Merchant-Id
string | null

Body

application/json
description
string | null

Human label for this key, e.g. 'Zunkiree prod'.

Maximum string length: 255

Response

Successful Response

Response from POST /sync-keys. The secret field is shown ONCE and never recoverable from the server afterwards. Frontends/CLIs must surface this clearly to the merchant.

id
string<uuid>
required
key_id
string
required
secret_prefix
string
required
description
string | null
required
created_at
string<date-time>
required
last_used_at
string<date-time> | null
required
revoked_at
string<date-time> | null
required
secret
string
required

The plaintext sync secret (ssk_sec_<...>). Returned only at creation time; cannot be retrieved later.