---
title: "Revoke"
method: POST
path: "/access_tokens/{id}/revoke"
tags: ["PersonalAccessTokens"]
---

# Revoke

`POST /access_tokens/{id}/revoke`

## Request

- Base URL: `https://api.ngrok.com`
- URL: `https://api.ngrok.com/access_tokens/{id}/revoke`
- Auth: HTTP bearer

Revoke an access token by ID. The token stops working within about two minutes. Unlike Delete, a revoked token remains visible in Get/List responses.

## Path parameters

- `id` string, required

## Headers

- `ngrok-version` integer, required

## Request body

- Item
  - `id` string: a resource identifier

## Response `204`

Revoke an access token by ID. The token stops working within about two minutes. Unlike Delete, a revoked token remains visible in Get/List responses.

## Other responses

- `4XX`: An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.
- `5XX`: An error. The body carries a machine-readable error_code and a human-readable msg; every code is documented at https://ngrok.com/docs/errors. A 429 with error code ERR_NGROK_226 means the account exceeded the documented request-rate limit.

## Changes

- **2026-11-03** `8418dcf65430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ngrok/apis/ngrok-openapi/changes/access_tokens/:id/revoke/post.md)

---

[API](https://skmtc.dev/ngrok/apis/ngrok-openapi.md) - [All operations](https://skmtc.dev/ngrok/apis/ngrok-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/ngrok/apis/ngrok-openapi/revisions/8418dcf65430?raw)