SenseCrypt Docs
API ReferenceAdmin Administration

List Admin Roles Across Tenants

GET/v1/admin/administration/admin-roles

Console 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
Range1 <= value <= 200
Default50
offset?Offset
Range0 <= value
Default0
tenant_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": {}    }  ]}