API ReferenceAdmin Administration
List Admin Roles Across Tenants
GET
/v1/admin/administration/admin-rolesConsole roles across every tenant the actor may read, in one page — the invite/edit-member modal's data source. Tenant resolution is host-only, so a page on one host can never call a sibling tenant's API; this account-scoped route serves the one legitimately cross-tenant read (an owner/delegated admin granting roles in several tenants at once) with the tenant explicit per row instead of ambient.
Standard list contract (q searches role name, limit/offset,
{items,total,limit,offset}), flat items ordered by (tenant, role) —
built-in Administrator/Viewer rows included, exactly like the per-tenant
list. tenant_id optionally narrows to one tenant; an unknown, unowned,
or not-visible id is uniformly 404.
Authorization
HTTPBearer AuthorizationBearer <token>
In: header
Query Parameters
q?Q
Default
""limit?Limit
Range
1 <= value <= 200Default
50offset?Offset
Range
0 <= valueDefault
0tenant_id?|null
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/admin/administration/admin-roles"{ "items": [ { "id": "string", "name": "string", "description": "string", "capability_count": 0, "system_kind": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "tenant_id": "string", "tenant_name": "string", "tenant_slug": "string" } ], "total": 0, "limit": 0, "offset": 0}{ "detail": [ { "loc": [ "string" ], "msg": "string", "type": "string", "input": null, "ctx": {} } ]}