Skip to main content
POST
Create API key

Authorizations

Authorization
string
header
required

Clerk session JWT for the web app, or a control-plane API key (so_…) from POST /api/v1/api-keys for programmatic / docs try-it use.

Body

application/json
name
string
required

Label for this key

Required string length: 1 - 120
Example:

"ci-deploy"

Response

Successful Response

id
string<uuid>
required
name
string
required
key_prefix
string
required

First characters of the secret for identification

created_at
string<date-time>
required
secret
string | null

Full secret — returned only once on create

Example:

"so_…"