Varmirdocs
Docs/API reference/DELETE /api/v1/keys/:id

DELETE/api/v1/keys/:id

Revoke a key immediately. Any in-flight request using it fails with 401. Usage history is preserved for audits.

Request

Requires a management key (keys:write). Only keys of your own account can be revoked; any other id returns 404 not_found. Revoking an already revoked key is not an error: you get 200 with the original revoked_at. A management key may revoke itself.

HTTP
DELETE https://api.varmir.com/api/v1/keys/key_8f3a2c
Authorization: Bearer <MANAGEMENT_KEY>

Response

{
  "id": "key_8f3a2c",
  "revoked_at": "2026-06-12T14:01:11Z"
}