Auth API reference

Auth API · Consumer-Tenant-Api-Keys

delete/{app_slug}/v1/tenant-api-keys/{key_id}Auth

Revoke an API key

Immediate and final. Idempotent: revoking a revoked key is a 204 that changes nothing.

Path parameters

app_slug*string

The app slug.

key_id*string

Key id (UUID) or display id (`tak_…`).

Headers

X-Heimdall-App-Keystring

The app's Platform API Key (`pcft_live_…`, holding `auth.tenant.api_keys.introspect` on this app). Required, next to the end user's bearer, when the app has set `management_lane: app_proxy_only`: the app's backend then proxies these routes and the end user cannot call them directly.

Response · 204

Revoked (or already revoked).

Example

Request

DELETE https://api.auth.productcraft.co/{app_slug}/v1/tenant-api-keys/{key_id}
Authorization: Bearer YOUR_TOKEN