Revoke an admin key

Revokes the admin key for good, the caller’s own included. Records key.revoked. Revoking a revoked key changes nothing. The last usable admin key is not revoked: create another first. Admin keys only.

Parameters

Name	In	Type	Description
`key_id`required	path	string · uuid	The key’s id

Request body

None.

Responses

204

The key is revoked

No content.

401

No valid key

Problem (application/problem+json)

403

Not an admin key (forbidden)

Problem (application/problem+json)

404

No such admin key (not_found)

Problem (application/problem+json)

409

The last usable admin key (conflict)

Problem (application/problem+json)

429

The key is over its rate limit, api.rate_limit_per_minute requests a minute on this node (rate_limited)

Header	Type	Description
`Retry-After`	integer	Seconds until the key’s next request passes; rounded up.

Problem (application/problem+json)

504

Postwind’s storage did not answer within its time limit (storage_timeout). A change the request makes may still take effect: check before repeating it. A repeat with the same Idempotency-Key never runs it twice: it is 409 idempotency_key_in_progress until the key’s 24 h end

Problem (application/problem+json)

bashRequest

# set POSTWIND_URL, POSTWIND_KEY and the ids first
curl -X DELETE "$POSTWIND_URL/api/v1/admin/keys/$KEY_ID" \
  -H "Authorization: Bearer $POSTWIND_KEY"

MCP tool `revoke_admin_key` requires confirm

Call it: when an admin key leaked or is no longer used.
Needs: an admin key, another usable admin key besides the one revoked (the last one is refused with conflict), and confirm: true; without it the call changes nothing and tells what it would do.
Returns: outcome (would_revoke, revoked, already_revoked), effect in words and the key as list_admin_keys shows it after the call; the API’s DELETE /api/v1/admin/keys/{key_id} answers 204.

jsontools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "revoke_admin_key",
    "arguments": {
      "key_id": "<key_id>",
      "confirm": false
    }
  }
}

Open the tool page