---
title: "Delete API token"
method: DELETE
path: "/api/v3/meta/tokens/{tokenId}"
tags: ["API Tokens"]
---

# Delete API token

`DELETE /api/v3/meta/tokens/{tokenId}`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/tokens/{tokenId}`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/tokens/:tokenId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Delete an API token by its ID.

**Note**: This endpoint accepts a session credential only. An API token is rejected with 401 `ERR_API_TOKEN_NOT_ALLOWED`; an OAuth access token with 403 `ERR_FORBIDDEN`.

**Note**: API Token APIs are available on all cloud-hosted plans, and on licensed self-hosted deployments (**Business** plan and above).
> **Beta**: These APIs are currently in beta and subject to change in future releases.

## Path parameters

- `tokenId` string, required

## Response `200`

Token deleted

- object
  - `deleted` boolean, required: Always true — a failed delete is reported as an error status.

## Other responses

- `401`: No credential was supplied, it was not valid, or this operation does not accept the kind of credential that was sent.
- `403`: Authenticated, but not allowed: the role is too low, the token scope does not cover the operation, or the plan does not include the feature or allows no more of this resource.
- `404`: The resource does not exist. Hooks and documents answer 404; most other resources answer 422 instead.
- `500`: Unexpected server error. The body carries `message` only — no `error` code.

## Changes

- **2026-10-13** `2ba4267a99d7`: 4 breaking, 7 info
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `title` from the response with the `200` status
  - removed the required property `updated_at` from the response with the `200` status
  - …7 more

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/tokens/:tokenId/delete.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)