Get RBAC Overview
Aggregate snapshot of the entire RBAC state for an endpoint — the full clients, roles, and memberships arrays returned together. One call instead of three. Use it to render the RBAC tab in the dashboard.
For the individual lists, use /clients, /roles, /memberships respectively.
Path parameters
id string (uuid) Req
Endpoint UUID.
Response (200 OK)
endpoint_id int64
Numeric endpoint ID.
clients array<object>
Full list of RBAC clients (same object shape as /clients).
roles array<object>
Full list of roles (same object shape as /roles).
memberships array<object>
Full list of
(client_id, role_id) pairings (same object shape as /memberships).Errors
401 Unauthorized
Missing auth.
403 Forbidden
Caller lacks the
endpoints:read permission in the active account.404 Not Found
Endpoint doesn't exist or doesn't belong to the calling account.
Request
curl "https://api.ngris.com/v1/endpoints/<uuid>/rbac" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
overview = client.endpoint_rbac.get_rbac("<endpoint_uuid>")
print(f"{len(overview['clients'])} clients, "
f"{len(overview['roles'])} roles")
Response — 200 OK
{
"endpoint_id": 184,
"clients": [
{
"id": 51,
"identifier": "alice@example.com",
"display_name": "Alice",
"email": "alice@example.com",
"status": "active",
"has_password": true,
"has_token": false,
"has_oauth": false,
"registration_source": "admin",
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-01T10:00:00Z"
}
],
"roles": [
{
"id": 9,
"name": "editor",
"priority": 10,
"is_default": false,
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-01T10:00:00Z"
}
],
"memberships": [
{
"id": 31,
"client_id": 51,
"role_id": 9,
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-01T10:00:00Z"
}
]
}