# Revoke Client Token

`POST /auth/oauth/revoke` · Core · Operator Sign-in

RFC 7009 revocation for a token from Redeem Authorization Code. A form-encoded `token=<access token>` ends that token's client session at once; the answer is the same 200 for an unknown, expired or another client's token. A browser call is answered only from a configured client's origin, without credentials.

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `token` | string | yes | The access token to revoke. Its client session ends at once. Example: `"eyJhbGciOiJFZERTQSJ9.eyJzdWIiOiJ1c3JfLi4uIn0.c2ln"`. |
| `token_type_hint` | enum ("access_token") | no | Optional; only access tokens exist here. |
| `client_id` | string | no | Optional: the client the token was issued to. When given, a token of another client is left alone. Example: `"playground"`. |

## Responses

- **200**: The token is no longer usable, or never was.

| Field | Type | Required | Description |
|---|---|---|---|
| `revoked` | enum (true) | yes | Always true (RFC 7009 §2.2): an unknown, expired or another client's token gets the same answer. |


## Errors

| HTTP | Code | When |
|---|---|---|
| 404 | `K9O_NOT_FOUND` | This deployment configures no OAuth clients. |
| 429 | `K9O_RATE_LIMITED` | Too many revocations from this address; wait and try again. |

## Code samples

### cURL

```bash
curl -X POST 'https://<org>.api-<region>.k9o.io/auth/oauth/revoke'
```

### fetch

```javascript
const res = await fetch('https://<org>.api-<region>.k9o.io/auth/oauth/revoke', {
  method: 'POST',
});
const { data, meta } = await res.json();
```


Canonical page: https://docs.kilimanjaro.dev/api-playground/core/revoke-client-token
