Skip to main content

Burn User Token

Burns a specific token owned by a user, removing it from circulation.

Request

POST /v2/admin/token/users/{token_id}/users/{user_id}/burn

Parameters

NameTypeInDescription
token_idstringpathRequired. The ID of the token to burn
user_idstringpathRequired. The ID of the user who owns the token

Headers

NameDescription
AuthorizationRequired. Bearer token for authentication
Content-TypeRequired. Must be application/json

Example

curl --location --request POST '\{\{baseUrl\}\}/v2/admin/token/users/68aeb272d9336c619ce249f6/users/680c02896d91ca0145cfeb81/burn' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Response

A successful response returns no content (HTTP 200 with empty body).

Status Codes

Status CodeDescription
200Success - Token has been burned successfully
400Bad Request - Invalid request parameters
401Unauthorized - Invalid or missing authentication token
404Not Found - Token ID or User ID does not exist
500Internal Server Error