---
title: "Revoke an API key. A revoked token yields the distinct 401 token_revoked envelope on use."
method: DELETE
path: "/v1/api-keys/{id}"
---

# Revoke an API key. A revoked token yields the distinct 401 token_revoked envelope on use.

`DELETE /v1/api-keys/{id}`

## Request

- Base URL: `https://api.usebubbles.com`
- URL: `https://api.usebubbles.com/v1/api-keys/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `204`

No content.

## Other responses

- `401`: Missing, malformed, or wrong-kind credential (unauthorized / token_revoked / account_deleted).
- `403`: The workspace cannot access paid features (pro_plan_required).
- `404`: The resource does not exist or is not readable by the caller (not_found).
- `409`: Constraint conflict, e.g. the active-key cap (invalid_request).
- `500`: An unexpected server error occurred (internal_error).

---

[API](https://skmtc.dev/usebubbles/apis/bubbles-public-api.md) - [All operations](https://skmtc.dev/usebubbles/apis/bubbles-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usebubbles/apis/bubbles-public-api/revisions/31570f5d4b05?raw)