get
https://{yourinstance}.makaira.io/role/
Returns one role by Auth0 role ID, including its permissions. Requires role:read or usermanagement.read.
Request
GET /role/{roleId}
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
roleId | string | Yes | Auth0 role ID (for example rol_abc123). |
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> (or HMAC headers, see Authentication) |
Response
{
"id": "rol_abc123",
"name": "Makaira.ADMIN",
"description": "Administrator",
"permissions": ["search.read", "search.write"]
}HTTP 404 if the role is not found.
Successful response