/{app_slug}/v1/admin/roles/{role_name}AuthRead one role with its permission set
Returns the role plus the flat `permissions[]` array currently bound. Use this to drive a "configure role" UI in the customer product without having to call `/permissions` separately.
Path parameters
app_slug*stringSlug of the app.
role_name*stringName of the role (e.g. `admin`).
Response · 200
id*stringUnique identifier of the role.
app_id*stringThe Auth app the role belongs to.
name*stringName of the role.
description*stringFree-text description of the role, or `null`.
is_system*booleanTrue for the built-in roles every app has; they cannot be renamed or deleted.
created_at*string · date-timeWhen the role was created (ISO 8601).
updated_at*string · date-timeWhen the role was last changed (ISO 8601).
permissions*arrayPermission keys (`resource.action`) the role grants.
Example
Request
GET https://api.auth.productcraft.co/{app_slug}/v1/admin/roles/{role_name}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "string",
"app_id": "string",
"name": "string",
"description": "string",
"is_system": false,
"created_at": "2026-01-01T00:00:00.000Z",
"updated_at": "2026-01-01T00:00:00.000Z",
"permissions": [
{
"id": "string",
"resource": "user",
"action": "read",
"description": "string"
}
]
}