Revoke a project key

Revokes the key for good: from then on it is refused with key_revoked. Records key.revoked. Revoking a revoked key changes nothing. An admin key may revoke any key of a live project; a project key needs scope keys, in its own project, and may revoke itself.

Parameters

Name	In	Type	Description
`project_id`required	path	string · uuid	The project’s id
`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

A project key without scope keys (forbidden)

Problem (application/problem+json)

404

No such project or key in it, or another project’s (not_found)

Problem (application/problem+json)

409

The project is deleted (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/projects/$PROJECT_ID/keys/$KEY_ID" \
  -H "Authorization: Bearer $POSTWIND_KEY"

MCP tool `revoke_api_key` requires confirm

Call it: when a key leaked or is no longer used.
Needs: an admin key with project_id, or a project key with scope keys (its own project; the argument is ignored; it may revoke itself), 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_api_keys shows it after the call; the API’s DELETE /api/v1/projects/{project_id}/keys/{key_id} answers 204.

jsontools/call

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

Open the tool page