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

# Revoke a token

`POST /v1/oauth/revoke`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/oauth/revoke`
- Auth: none required

Revokes an access or refresh token. Every token outcome always returns 200 — including a token that does not exist, is already revoked, or is malformed — so the endpoint can never be used to probe whether a token exists. The one exception is failed client authentication, which returns 401.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=post&path=%2Fv1%2Foauth%2Frevoke) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dpost%26path%3D%252Fv1%252Foauth%252Frevoke%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dpost%26path%3D%252Fv1%252Foauth%252Frevoke%20and%20help%20me%20integrate%20this%20endpoint.)

## Request body

- OAuthRevokeRequest: Body of `POST /v1/oauth/revoke`. Sent form-encoded per RFC 7009, or as JSON.
  - `token` string, required
  - `token_type_hint` 'access_token' | 'refresh_token'
  - `client_id` string, required
  - `client_secret` string

## Response `200`

Revoked

## Other responses

- `401`: `invalid_client` — the only case that is not reported as success. Every token outcome (revoked, already revoked, unknown, malformed) always returns 200; only failed client authentication returns 401.
- `500`: Unexpected server error.

## Changes

- **2026-09-28** `68e588d7c7b6`: 1 info
  - added the media type `application/x-www-form-urlencoded` to the request body
- **2026-09-17** `6b55ce24462c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/assinafy/apis/assinafy-api-reference/changes/v1/oauth/revoke/post.md)

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/f7da81a5567e?raw)