---
title: "Revoke an API key"
method: DELETE
path: "/api-keys/{api_key_id}"
tags: ["API Keys"]
---

# Revoke an API key

`DELETE /api-keys/{api_key_id}`

## Request

- Base URL: `https://developers.ozav.io/v2`
- URL: `https://developers.ozav.io/v2/api-keys/{api_key_id}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Revokes an API key immediately; subsequent requests presenting that key
fail authentication. Returns `204 No Content`. Irreversible - mint a new
key to replace a revoked one. Live.

## Path parameters

- `api_key_id` string, required

## Response `204`

Revoked.

## Other responses

- `401`: Missing or invalid API key.
- `404`: The resource does not exist, is not visible to the caller, or the id was malformed for this position (see "Resource ids" under Errors). These share one status; `code` and `message` tell them apart.

---

[API](https://skmtc.dev/ozav/apis/ozav-api.md) - [All operations](https://skmtc.dev/ozav/apis/ozav-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ozav/apis/ozav-api/revisions/4133dc2109d7?raw)