---
title: "Revoke Grant"
method: POST
path: "/v1/oauth/grants/{client_id}/revoke"
tags: ["oauth-grants"]
---

# Revoke Grant

`POST /v1/oauth/grants/{client_id}/revoke`

## Request

- Base URL: `https://api.bitpoort.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bitpoort.com/v1/oauth/grants/{client_id}/revoke`
- Auth: none required

Revoke every access + refresh token issued to ``client_id`` for
the authenticated account. Returns 200 with the count of tokens
flipped (``access_revoked`` + ``refresh_revoked``).

404 ``GRANT_NOT_FOUND`` when no active grant exists for that
(account, client). Idempotent calls hit this branch -- the second
Revoke click on a row that's already gone returns 404, which the
UI handles by just refreshing the list.

## Path parameters

- `client_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/bitpoort/apis/bitpoort-api.md) · [All operations](https://skmtc.dev/bitpoort/apis/bitpoort-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitpoort/apis/bitpoort-api/revisions/1a51d8566777?raw)
