---
title: "Bulk revoke authentication tokens"
method: POST
path: "/o/bulk_revoke/"
tags: ["Bearer Tokens"]
---

# Bulk revoke authentication tokens

`POST /o/bulk_revoke/`

> 📘 Authentication Guide
>
> For comprehensive details about authenticating with the Forage API, refer to the [authentication guide](https://docs.joinforage.app/docs/authentication).

A `POST` request to `/o/bulk_revoke/` deletes a specified number of [authentication tokens](https://docs.joinforage.app/docs/authentication#authentication-tokens).

Tokens are revoked in chronological order based on expiry time. For example, setting `revoke_count` to `50` deletes the `50` oldest tokens. The `revoke_count` value can range between `1` and `1000`.

## Request body

- BulkRevokeTokenRequest — The configuration for the bulk token revocation.
  - `client_id` string, required — The client ID for your application, found in the Forage dashboard ([sandbox](https://dashboard.sandbox.joinforage.app/), [production](https://dashboard.joinforage.app/)).
  - `client_secret` string, required — The client secret for your application, found in the Forage dashboard ([sandbox](https://dashboard.sandbox.joinforage.app/), [production](https://dashboard.joinforage.app/)).
  - `revoke_count` integer, required — The number of tokens to revoke, between `1` and `1000`. Tokens are revoked in chronological order based on expiry time.

## Response `200`

__OK__ - Success

## Other responses

- `401` — __Unauthorized__

---

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