curl -X DELETE https://api.voxmind.ai/organisations/42/api-tokens/8 \
-H "Authorization: Bearer YOUR_API_TOKEN"
resp = requests.delete(
"https://api.voxmind.ai/organisations/42/api-tokens/8",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
# 200 = deleted successfully
{
"id": 8,
"friendly_name": "production-server-01",
"enabled": false,
"created_at": "2025-03-01T09:00:00Z",
"updated_at": "2025-03-15T12:00:00Z"
}
API Tokens
Delete Token
Permanently delete an API token record. The token is immediately invalidated and cannot be recovered.
DELETE
/
organisations
/
{orgId}
/
api-tokens
/
{tokenId}
curl -X DELETE https://api.voxmind.ai/organisations/42/api-tokens/8 \
-H "Authorization: Bearer YOUR_API_TOKEN"
resp = requests.delete(
"https://api.voxmind.ai/organisations/42/api-tokens/8",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
# 200 = deleted successfully
{
"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 return401 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
string
required
Your organisation’s unique identifier.
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"
resp = requests.delete(
"https://api.voxmind.ai/organisations/42/api-tokens/8",
headers={"Authorization": "Bearer YOUR_API_TOKEN"},
)
# 200 = deleted successfully
{
"id": 8,
"friendly_name": "production-server-01",
"enabled": false,
"created_at": "2025-03-01T09:00:00Z",
"updated_at": "2025-03-15T12:00:00Z"
}