---
title: "Revoke API token"
method: DELETE
path: "/admin/api_tokens/{id}"
tags: ["API tokens"]
---

# Revoke API token

`DELETE /admin/api_tokens/{id}`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/admin/api_tokens/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

Revokes the token: it stops authenticating immediately, and every other token keeps working. The row is
kept as the audit trail, so the token still appears in the list with `revoked_at` set. Revoking an
already-revoked token answers 200 again; a token outside your account answers 404.

## Path parameters

- `id` integer, required

## Response `200`

Successful Response

## Other responses

- `403`: The credentials are valid but this user may not perform the action (permissions, a read-only token, or API access switched off).
- `404`: No record with that id is visible to this user. Records owned by other users that you cannot see also answer 404.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)