Revoke Key

Permanently deactivate an API key.

DELETE /v1/keys/{id}

Revoke Key

cURL

curl --request DELETE \
  --url https://api.example.com/v1/keys/{id}

Revoke Key

Permanently deactivates an API key. All subsequent requests using this key will receive 401 Unauthorized.

This action is irreversible. If you need a replacement key, use key rotation instead.

Path Parameters

id · string · required

The UUID of the key to revoke.

Authentication

Requires an API key with admin scope.

Response

{
  "message": "Key revoked"
}

Example

curl -X DELETE https://api.gimme.fast/v1/keys/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: gf_admin_key_here"

Errors

Status	Code	Description
401	UNAUTHORIZED	Missing or invalid API key
403	FORBIDDEN	Key doesn’t have admin scope
404	NOT_FOUND	Key ID doesn’t exist or is already revoked