---
title: "Revoke a superseded private API key"
method: POST
path: "/v1/auth/keys/{key_id}/revoke"
tags: ["Auth"]
---

# Revoke a superseded private API key

`POST /v1/auth/keys/{key_id}/revoke`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/auth/keys/{key_id}/revoke`
- Auth: HTTP bearer

Requires a stable Idempotency-Key and must be authenticated by a different verified owner key. The server refuses to revoke the current or only surviving key.

## Path parameters

- `key_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `reason` string, required

## Response `200`

OK

- object
  - `key_id` string, required
  - `prefix` string, required
  - `revoked_at` integer, required
  - `idempotent_replay` boolean, required
  - `next_action` string, required

## Other responses

- `409`: The target is current, is the only surviving key, or changed before guarded revocation
- `default`: Error

---

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