Revoke or Delete API Key

Revoke an API key (soft disable) or permanently delete it.

DELETE /api/keys

Revoke or Delete API Key

cURL

curl --request DELETE \
  --url https://encrata.com/api/keys \
  --header 'Authorization: Bearer <token>'

200

{
  "message": "Key revoked successfully"
}

Authentication

Requires an API key in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Request

id · string · required

The ID of the API key to revoke or delete.

permanent · string

Set to true to permanently delete the key instead of revoking it.

Revoke (soft disable)

curl -X DELETE "https://encrata.com/api/keys?id=key_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete (permanent removal)

curl -X DELETE "https://encrata.com/api/keys?id=key_abc123&permanent=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "message": "API key revoked"
}

Or for permanent deletion:

{
  "message": "API key deleted"
}

Revocation is immediate — any requests using the key will return 401. Permanent deletion removes the key record entirely and cannot be undone.

200

{
  "message": "Key revoked successfully"
}