Skip to main content
POST
Create API key

Authorizations

Authorization
string
header
required

API key with the vk_ prefix. Create one from the dashboard.

Body

application/json
name
string
required
email
string | null

Server-injected display email for the authenticated user. Set by the web proxy from the signed-in Clerk session (never trusted from a browser body). Absent for keys minted outside the proxy (SDK, CI). When present, it upserts users.email so /v1/me and the CLI can show the account.

Response

The created key, including the plaintext value returned once

object
string
required
id
string
required
name
string
required
key_prefix
string
required
created_at
string<date-time>
required
key
string
required

Plaintext key returned ONCE on creation. Save it immediately.

last_used_at
string<date-time> | null