/{app_slug}/v1/tenant-api-keys/configAuthRead this app's tenant API key settings
Requires `auth.tenant.api_keys.configure` on the app.
Path parameters
app_slug*stringThe app slug.
Response · 200 The effective settings.
enabled*booleanEffective: `false` whenever there is no grantable scope.
grantable_scopes*arrayThe scopes a tenant API key of this app can carry.
manage_roles*arrayTenant roles whose members may create, rotate and revoke keys.
Example: ["owner"]
management_lane*object`direct`: an end user's bearer alone can manage keys. `app_proxy_only`: only together with the app's PAK in `X-Heimdall-App-Key`.
default_expiry_days*objectLifetime in days when the creator names none.
max_expiry_days*objectLongest lifetime in days a key may have.
require_recent_mfa_minutes*integerWhen set, creating or rotating a key needs a second factor verified within this many minutes; `null` when off.
suspended*booleanPlatform kill switch (console / Auth-admin only).
pushed_by_app_at*string · date-timeWhen the app's own backend last pushed this config (`PUT /:appSlug/v1/tenant-api-keys/config`); `null` if it never has. Set by the server, never by a request. While set, the console treats the app's fields as owned by the app's code and shows them read-only; `suspended` stays the platform's.
Example
Request
GET https://api.auth.productcraft.co/{app_slug}/v1/tenant-api-keys/config
Authorization: Bearer YOUR_TOKENResponse
{
"enabled": false,
"grantable_scopes": [
{
"name": "disputes.read",
"description": "Read disputes"
}
],
"manage_roles": [
"owner"
],
"management_lane": {},
"default_expiry_days": {},
"max_expiry_days": {},
"require_recent_mfa_minutes": 0,
"suspended": false,
"pushed_by_app_at": "2026-01-01T00:00:00.000Z"
}