List Role Memberships
List every (client_uuid, role_uuid) pairing on this endpoint. Useful for building a "who has what role" matrix in admin tooling. Not paginated — this isn't expected to grow huge per endpoint (a typical app has dozens to hundreds of clients × a handful of roles).
Filter client-side to render the matrix you need, or pair with clients + roles for full join data.
Path parameters
uuid string (uuid) Req
The endpoint's
uuid from /endpoints.Response (200 OK)
A bare JSON array of membership objects (not wrapped in an envelope), no specific order; [] when there are none.
[].client_uuid, role_uuid string (uuid)
The pairing. A membership has no public id of its own; it is addressed by this pair.
[].assigned_by_uuid string (uuid)?
The
uuid of the account user who granted the membership. Omitted if unknown. Useful for audit trails.[].created_at, updated_at datetime
When the membership was created / last updated.
Deprecated: until the sunset this response also carries the legacy integer id, client_id, role_id and assigned_by fields. Don't use them; read the *_uuid fields.
Errors
401 Unauthorized
Missing auth.
404 Not Found
Endpoint doesn't exist.
Request
curl "https://api.ngris.com/v1/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/memberships" \
-H "X-API-KEY: <your_api_key>"
Python — build a who-has-what map
from collections import defaultdict
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
mems = client._get_raw("/endpoints/019bb1e4-e785-77d2-9966-c3cff31d0a0e/rbac/memberships")
by_client = defaultdict(list)
for m in mems:
by_client[m["client_uuid"]].append(m["role_uuid"])
for client_uuid, roles in by_client.items():
print(f"client {client_uuid}: roles {roles}")
Response — 200 OK
[
{"client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee", "role_uuid": "019b5fc1-0eb5-7dd8-a0e9-a575428f890d", "assigned_by_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "created_at": "2026-04-01T00:00:00Z", "updated_at": "2026-04-01T00:00:00Z"},
{"client_uuid": "019b4b9d-d300-736b-8601-153b3d9f70ee", "role_uuid": "019b6243-8510-7cbb-a69c-6e29c89b0d65", "assigned_by_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "created_at": "2026-04-29T13:00:00Z", "updated_at": "2026-04-29T13:00:00Z"},
{"client_uuid": "019b5725-4607-7367-bf7d-30155d363ab9", "role_uuid": "019b6243-8510-7cbb-a69c-6e29c89b0d65", "assigned_by_uuid": "019a52c2-ca1e-78ba-ab5c-50362cc29134", "created_at": "2026-04-15T00:00:00Z", "updated_at": "2026-04-15T00:00:00Z"}
]
Was this helpful?