---
title: "Revoke tokens"
method: DELETE
path: "/oauth2/tokens"
tags: ["OAuth API"]
---

# Revoke tokens

`DELETE /oauth2/tokens`

Revoke an access token or refresh token. Once revoked, the token can no longer be used.

Revoking a refresh token revokes all access tokens that were created using the same authorization.

This endpoint can only be accessed using **OAuth client credentials**.

## Headers

- `Authorization` string, required
- `Content-Type` string
- `idempotency-key` string

## Request body

- object
  - `token_type_hint` 'access_token' | 'refresh_token', required
  - `token` string, required — The token you want to revoke.

## Response `204`

An empty response.

## Other responses

- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-19** `ffd62224620b` — 2 info
  - the endpoint scheme security `basicAuth` was added to the API
  - the endpoint scheme security `oAuth` was removed from the API
- **2026-04-27** `a5774ab4d465` — 1 breaking, 2 info
  - request property `token_type_hint` was restricted to a list of enum values
  - added the new `access_token` enum value to the request property `token_type_hint`
  - added the new `refresh_token` enum value to the request property `token_type_hint`

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/oauth2/tokens/delete.md)

---

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