Auth API reference

Auth API · Consumer-Admin-Permissions

get/{app_slug}/v1/admin/permissionsAuth

List all permissions visible to this app

Returns the union of system permissions (shared across every app — `is_system: true` in the response) and any custom entries this app has defined (`is_system: false`). Useful for driving a role-editor UI that picks from the full catalogue.

Path parameters

app_slug*string

Slug of the app.

Response · 200

Array of object

id*string

Unique identifier of the permission.

app_id*string

App scope. `null` for system permissions.

resource*string

Resource half of the permission key (`resource.action`).

Example: "user"

action*string

Action half of the permission key (`resource.action`).

Example: "read"

description*string

Free-text description of the permission, or `null`.

created_at*string · date-time

When the permission was created (ISO 8601).

is_system*boolean

True iff the row is a system (shared) permission.

Example

Request

GET https://api.auth.productcraft.co/{app_slug}/v1/admin/permissions
Authorization: Bearer YOUR_TOKEN

Response

[
  {
    "id": "string",
    "app_id": "string",
    "resource": "user",
    "action": "read",
    "description": "string",
    "created_at": "2026-01-01T00:00:00.000Z",
    "is_system": false
  }
]