Skip to main content
DELETE
https://api.voxmind.ai
/
organisations
/
{orgId}
/
api-tokens
/
{tokenId}
curl -X DELETE https://api.voxmind.ai/organisations/42/api-tokens/8 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "id": 8,
  "friendly_name": "production-server-01",
  "enabled": false,
  "created_at": "2025-03-01T09:00:00Z",
  "updated_at": "2025-03-15T12:00:00Z"
}

​
Overview

Permanently removes a token from your organisation. Any API request using this token after deletion will return 401 Unauthorized. Unlike disabling a token (PATCH), deletion is irreversible — use it for tokens that are confirmed decommissioned and no longer needed for audit trail purposes.
Deleting a token that is still in use by a production service will immediately break those API calls. Confirm the token is no longer in use before deleting. When in doubt, disable first (PATCH enabled: false) and monitor for 401 errors before proceeding to delete.

​
Path Parameters

​
orgId
string
required
Your organisation’s unique identifier.
​
tokenId
string
required
The numeric ID of the token to permanently delete.
curl -X DELETE https://api.voxmind.ai/organisations/42/api-tokens/8 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "id": 8,
  "friendly_name": "production-server-01",
  "enabled": false,
  "created_at": "2025-03-01T09:00:00Z",
  "updated_at": "2025-03-15T12:00:00Z"
}