---
title: "Revoke Refresh Token"
method: POST
path: "/api/v1/token/revoke"
tags: ["External: Token"]
---

# Revoke Refresh Token

`POST /api/v1/token/revoke`

Revoke a refresh token.

Use this endpoint to invalidate a refresh token, for example when
logging out or when a token is compromised. This follows the OAuth 2.0
Token Revocation specification (RFC 7009) which uses POST.

Args:
    payload: Request containing the refresh token to revoke
    db: Database session

Raises:
    404: If the refresh token is not found

## Request body

- RefreshTokenRequest — Request to exchange refresh token for new access token.
  - `refresh_token` string, required

## Response `204`

Successful Response

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)