---
title: "Revoke OAuth token"
method: POST
path: "/api/v1/external/auth/revoke"
tags: ["Authentication"]
---

# Revoke OAuth token

`POST /api/v1/external/auth/revoke`

## Request

- Base URL: `https://api.wove.com`
- URL: `https://api.wove.com/api/v1/external/auth/revoke`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/wove/apis/wove-external-api/docs/api/v1/external/auth/revoke/post.ts> (a function with typed inputs; its response is checked against the schema)

Revoke an OAuth access token to immediately invalidate it.
This is useful when a token is compromised or no longer needed.

## Request body

- object
  - `token` string: The token to revoke (optional, defaults to current token)
  - `token_type_hint` 'access_token' | 'refresh_token': Hint about the token type

## Response `200`

Token revoked successfully

- SuccessResponse
  - `success` boolean, required
  - `data` object, required: Response data (varies by endpoint)
  - `message` string: Optional success message

## Other responses

- `401`: Invalid or expired token

---

[API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)