API documentation

DELETE /tokens/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/tokens/:id

Destroy Token by id.

Hides the token rather than deleting its record: clears its display colors, disables inheriting its value from the previous call, and marks it hidden so it drops out of default list results, while its historical values are kept. Requires a superuser account with the Setup System and destroy permissions.

Example Request

curl -X DELETE 'https://[your-subdomain].trackdrive.com/api/v1/tokens/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "string": {
    "id": 10002,
    "type": "Token",
    "uuid": "a6af7847-1b1e-4760-ac0d-e1813a6d3a09",
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": "/tokens/10001",
    "routes_edit_path": "/tokens/10001/edit",
    "external_record_id": null,
    "name": "roof_shade",
    "key": "roof_shade",
    "company_id": 10003,
    "color": null,
    "hidden": true,
    "background_color": null,
    "static_value": null,
    "use_static_value": null,
    "description": null,
    "acceptable_tokens_enabled": false,
    "text_color": null,
    "sortable_order": -12,
    "html_key": "<span class=\"token-html-key\" style=\"color: ; background-color: \">roof_shade</span>",
    "type_underscore": "string",
    "inherit_from_previous_call": true
  },
  "metadata": {
    "root": "string"
  }
}