---
title: "Revoke Token"
method: POST
path: "/v2/auth/tokens/revoke"
tags: ["App user provisioning"]
---

# Revoke Token

`POST /v2/auth/tokens/revoke`

## Request

- Base URL: `https://api.village.ai`
- URL: `https://api.village.ai/v2/auth/tokens/revoke`
- Auth: HTTP bearer

Invalidate the current Bearer token. Use this when a user logs out or when you need to force re-authentication. The token is added to a revocation list and can no longer be used. To restore access, generate a new token via create_auth_token.

## Response `200`

Token revoked successfully

- object
  - `data` RevokeTokenResponse, required: Token revocation response
    - `message` string, required: Success message
  - `metadata` object, required
    - `request_id` string, required

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - missing or invalid authentication

---

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