> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxmind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Token

> Permanently delete an API token record. The token is immediately invalidated and cannot be recovered.

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

<Warning>
  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.
</Warning>

## Path Parameters

<ParamField path="orgId" type="string" required>
  Your organisation's unique identifier.
</ParamField>

<ParamField path="tokenId" type="string" required>
  The numeric ID of the token to permanently delete.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.voxmind.ai/organisations/42/api-tokens/8 \
    -H "Authorization: Bearer YOUR_API_TOKEN"
  ```

  ```python Python theme={null}
  resp = requests.delete(
      "https://api.voxmind.ai/organisations/42/api-tokens/8",
      headers={"Authorization": "Bearer YOUR_API_TOKEN"},
  )
  # 200 = deleted successfully
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": 8,
    "friendly_name": "production-server-01",
    "enabled": false,
    "created_at": "2025-03-01T09:00:00Z",
    "updated_at": "2025-03-15T12:00:00Z"
  }
  ```
</ResponseExample>