get
https://{yourinstance}.makaira.io/role
Returns default Makaira.* roles and, when Role Manager is booked, custom {customer}.* roles. Requires role:read or usermanagement.read.
Request
GET /role
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
q | string | "" | Case-insensitive name filter. |
_start | integer | 0 | Pagination offset. |
_end | integer | 10 | End index (exclusive). Page size is _end - _start. |
withPermissions | boolean | false | When true, each role includes a permissions array. |
Headers
| Header | Value |
|---|---|
Authorization | Bearer <token> (or HMAC headers, see Authentication) |
Response
JSON array of roles. Total count is in the X-Total-Count header.
Example Response
[
{
"id": "rol_abc123",
"name": "Makaira.ADMIN",
"description": "Administrator"
}
] 200Successful response

