Auth API reference

Auth API · Consumer-Tenant-Api-Keys

get/{app_slug}/v1/tenant-api-keysAuth

List the active tenant's API keys

Newest first, cursor-paginated (20 per page, max 100). Secrets are never returned; `key_prefix` and `last4` identify a key.

Path parameters

app_slug*string

The app slug.

Query parameters

statusenum (3)

Only keys in this state.

limitinteger

Page size. Defaults to 20, clamped to 100.

cursorstring

`next_cursor` from the previous page.

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 · 200 A page of keys.

data*array

The tenant API key items on this page.

pagination*object
next_cursor*string

Opaque cursor for the next page. `null` when no more pages are available.

Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"

has_more*boolean

True iff another page exists; if true, pass `next_cursor` on the next request.

Example: false

Example

Request

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

Response

{
  "data": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "display_id": "tak_3a9f2b1c0d4e",
      "tenant_id": "00000000-0000-0000-0000-000000000000",
      "tenant_display_id": "tnt_3a9f2b1c0d4e",
      "name": "CI e2e",
      "key_prefix": "pctk_live_4fQ2aZ",
      "last4": "x9Qb",
      "scopes": [
        "disputes.read"
      ],
      "status": {},
      "created_by_account_id": "00000000-0000-0000-0000-000000000000",
      "created_at": "2026-01-01T00:00:00.000Z",
      "expires_at": "2026-01-01T00:00:00.000Z",
      "last_used_at": "2026-01-01T00:00:00.000Z",
      "revoked_at": "2026-01-01T00:00:00.000Z",
      "revoke_reason": {},
      "rotated_from": "00000000-0000-0000-0000-000000000000"
    }
  ],
  "pagination": {
    "next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
    "has_more": false
  }
}