Skip to main content
curl

Authorizations

Authorization
string
header
required

A management token: ds_mgmt_ followed by 40 lowercase hexadecimal characters, created by an owner in Settings → Management tokens. Opaque: send it as is, in the Authorization header only.

Body

application/json

Send Content-Type: application/json and a JSON object of at most 262,144 bytes.

name
string

Optional. Trimmed; absent, empty or blank: no name. Names need not be unique.

Response

The key was created.

A delivery API key just created. This is the only response that ever holds the full key.

id
string
required

Stable key id (key_…).

name
string | null
required

The key name, or null.

prefix
string
required

The first 12 characters of the key: what the console and GET /v1/keys show from now on.

key
string
required

The full key: ds_live_ followed by 40 lowercase hexadecimal characters. Shown in this response only — store it now. It cannot be read again.

created_at
string<date-time>
required

Creation time, UTC.