Skip to content

Revoke an API key

DELETE
/api/api-keys/{keyId}

Permanently revokes an API key. Once revoked, any requests using this key will be rejected immediately. This also evicts the key from the authentication cache. This action cannot be undone — you will need to create a new key if access is needed again.

keyId
required
string format: uuid

The unique identifier of the API key to revoke.

The API key has been revoked and is no longer valid.

Simple success acknowledgment returned by action endpoints (reply, resolve, take-over, etc.).

object
ok
required

Always true on success.

boolean
Example
true

No API key exists with the given ID in the authenticated tenant.

Standard error response returned by all endpoints on failure.

object
error
required

A human-readable error message describing what went wrong.

string
Example
Conversation not found