---
title: "Revoke Oauth Token"
method: DELETE
path: "/oauth-tokens/{id}"
tags: ["OauthTokens"]
---

# Revoke Oauth Token

`DELETE /oauth-tokens/{id}`

## Request

- Base URL: `https://api.purplegrain.com/api/v1`
- URL: `https://api.purplegrain.com/api/v1/oauth-tokens/{id}`
- Auth: HTTP bearer

Revoke one token: it stops authenticating immediately and its refresh
token dies with it. Sign out a device, disconnect an AI agent, or kill
a token an api credential minted.

## Path parameters

- `id` string, required

## Response `204`

Revoked.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/purplegrain/apis/purple-grain-api.md) · [All operations](https://skmtc.dev/purplegrain/apis/purple-grain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/purplegrain/apis/purple-grain-api/revisions/29c5c990d66e?raw)