Skip to main content
DELETE
Revoke an API key

Authorizations

Authorization
string
header
required

Your account's secret key: Authorization: Bearer sk_test_… or sk_live_…. Server-side only.

Headers

Idempotency-Key
string

A unique key per operation (a UUID works). Retrying with the same key returns the original response.

Path Parameters

keyID
string<uuid>
required

Response

Success.

id
string<uuid>
required
prefix
string
required

sk_test, sk_live, pk_test or pk_live.

Example:

"sk_live"

kind
enum<string>
default:secret
required
Available options:
secret,
publishable
lastFour
string
required

The last four characters

tier
enum<string>
required

Rate-limit tier.

Available options:
free,
pro,
enterprise
scopes
string[]
required
createdAt
string<date-time>
required
name
string
revokedAt
string<date-time> | null

When it was revoked. null while active.

value
string

The full secret. Only present in the create response.