Delete an API token

DELETE

/api/api-tokens/{id}

Permanently revokes and deletes an API token. The authenticated user must be the token owner (DELETE). Any client still presenting the token will immediately fail authentication. This action cannot be undone.

Authorizations

ApiToken

Long-lived API token created via POST /api/api-tokens (returned once in plaintext). A token created with readOnly may only perform safe requests (GET, HEAD, OPTIONS); write requests are rejected on every endpoint.

Type

API Key (header: X-API-TOKEN)

or

JWT

JWT access token obtained via POST /api/auth/login. Send as: Authorization: Bearer .

Type

HTTP (bearer)

Parameters

Path Parameters

id*

api-token identifier

Type

string

Required

Responses

api-token resource deleted

DELETE

/api/api-tokens/{id}

Playground

Authorization

ApiToken

Variables

Key

Value

id*

Samples

Powered by VitePress OpenAPI