---
title: "Revoke a token"
method: POST
path: "/oauth/token/revoke"
tags: ["oauth"]
---

# Revoke a token

`POST /oauth/token/revoke`

Revokes an access or refresh token. Only tokens issued for system users are currently supported. Revoked tokens become immediately invalid and unusable.

## Response `200`

The request has succeeded.

## Other responses

- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `default` — An unexpected error response.

## Changes

- **2026-06-04** (v5) `b698c180678a` — 3 breaking, 1 info
  - added `#/components/schemas/TokenTypeHint` to the `token_type_hint` request property `allOf` list
  - removed the enum value `access_token` of the request property `token_type_hint`
  - removed the enum value `refresh_token` of the request property `token_type_hint`
  - the `token_type_hint` request property type/format was generalized from `string`/`` to ``/``
- **2025-07-16** (v5) `43134ca41f18` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/oauth/token/revoke/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)