Revoke tokens

{
  "success": true,
  "message": "Token revoked successfully"
}

Revoke a token by its ID to immediately invalidate it. Requires token:revoke or token:* permission. Once revoked, the token can no longer be used for authentication.

Request parameters

token_id

uuid

required

The unique identifier (JTI) of the token to revoke.

Revoke a token

TypeScript
Python
cURL

// TODO: Add TypeScript SDK example for revoking tokens

# TODO: Add Python SDK example for revoking tokens

curl -X POST "${API_URL}/v1/token/revoke" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "token_id": "550e8400-e29b-41d4-a716-446655440000"
  }'

{
  "success": true,
  "message": "Token revoked successfully"
}

Error responses

Status	Description
403	Missing `token:revoke` permission
404	Token not found
400	Token already revoked

Revoking an already-revoked token returns a 400 error. Use the list endpoint with include_invalid=true to check token status before revoking.

List tokens

⌘I

Getting started

Connectors

Configuration

Outputs

Jobs

Files

Admin

Request parameters

Revoke a token

Error responses

Getting started

Connectors

Configuration

Outputs

Jobs

Files

Admin

​Request parameters

​Revoke a token

​Error responses

Request parameters

Revoke a token

Error responses