Revoke an API key

DELETE/v1/api_keys/{id}

Permanently revokes a key. Already-revoked or unknown keys return 404.

Requires an API key (bearer), scoped to the active org. Supports idempotency keys.

Path parameters

idstringrequired

Returns

200The revoked key.

Failures use the standard error envelope with a closed set of codes.

Terminal

renza keys revoke key_8KxQ2v…

DELETE /v1/api_keys/{id}

curl https://api.renza.io/v1/api_keys/key_8KxQ2v… \
  -H "Authorization: Bearer $RENZA_API_KEY" \
  -X DELETE

TypeScript

import { createRenzaClient } from "renza-sdk";

const renza = createRenzaClient({ apiKey: process.env.RENZA_API_KEY! });

const key = await renza.apiKeys.revoke("key_8KxQ2v…");

Response 200

{
  "id": "key_8KxQ2v…",
  "object": "api_key",
  "name": "CI deploy key",
  "prefix": "rza_sk_live_8KxQ2v",
  "last4": "aB3z",
  "mode": "live",
  "scopes": [],
  "kind": "user",
  "acts_as": "usr_1a2b…",
  "created_by": "usr_1a2b…",
  "last_used_at": null,
  "revoked_at": null,
  "created_at": "2026-06-19T10:30:00.000Z"
}