Delete Token

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"
}

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 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

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"
}

Voice Core

API Tokens

Organisation

Users

Billing

Devices & Texts

Overview

Path Parameters

​Overview

​Path Parameters

Overview

Path Parameters