Revoke a scoped API key (project ADMIN)

Marks the key revoked and flushes the KV cache immediately (does not wait for TTL). Idempotent — re-revoking an already-revoked key returns 200.

Authorizations

• SessionCookie

Parameters

Path Parameters

projectId

required

string

id

required

string

Responses

200

Revoked (or already revoked)

Media typeapplication/json

object

key

object

id

string

projectId

string

name

string | null

scopes

Array<string>

Allowed values: ingest:write decision:read coupon:redeem coupon:read metrics:read metrics:write profile:write decision:call tracking:ingest mcp:events_read mcp:events_write mcp:links_write mcp:attribution_read

revoked

boolean

createdAt

string

revokedAt

string | null

keyMasked

string

message

string

400

Missing projectId

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

401

Not authorized

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

403

Needs project ADMIN

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}

404

Key not found

Media typeapplication/json

object

error

required

Human-readable error message.

string

message

string

Example^generated

json

{
  "error": "example",
  "message": "example"
}