Auth API reference

Auth API · Consumer-Tenant-Api-Keys

get/{app_slug}/v1/tenant-api-keys/configAuth

Read this app's tenant API key settings

Requires `auth.tenant.api_keys.configure` on the app.

Path parameters

app_slug*string

The app slug.

Response · 200 The effective settings.

enabled*boolean

Effective: `false` whenever there is no grantable scope.

grantable_scopes*array

The scopes a tenant API key of this app can carry.

manage_roles*array

Tenant 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*object

Lifetime in days when the creator names none.

max_expiry_days*object

Longest lifetime in days a key may have.

require_recent_mfa_minutes*integer

When set, creating or rotating a key needs a second factor verified within this many minutes; `null` when off.

suspended*boolean

Platform kill switch (console / Auth-admin only).

pushed_by_app_at*string · date-time

When 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_TOKEN

Response

{
  "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"
}