Projects the Network's roster roles with holders and referencing agent contacts.
Inverts the People surface: instead of listing participants and the roles each one carries, this lists every roster role in the Network and, for each, who holds it and which agent contacts defer to it. A holder is reported with every tier that grants the role — `EXPERTISE` for a tenant-level expertise tag that applies everywhere, `EDGE_ROLE` for a tag on a member edge in this Network — and an edge-granted holder names the agents whose edge grants it, since that is the only place the tag can be removed. `consultable` reports whether a consult-allowed member edge exists: a holder without one is still reachable for delivery through a role-bound contact but is refused for `consult_for_role`. A role with references and no holders is the actionable gap this surface exists to expose — deliveries and consults to it refuse at runtime. Roles group case-insensitively and are reported using the tenant capability catalog's casing; `inCatalog` distinguishes a catalog role from one that exists only as an ad-hoc tag. Read-only and fully derived from existing expertise, member-edge, and contact-slot state — it adds no storage of its own, so nothing here can drift from the People surface. The whole role vocabulary is projected in memory before paging — it is tens of names, not thousands (participants are paged on the People surface, not here) — so a page is a slice of the complete, fully ordered result and omitting `pageSize` returns everything.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The owning Network id.
uuidThe tenant identifier
Query Parameters
The maximum number of items to return per page
int32int32Opaque cursor token from an external system (e.g. RAG API). When set, M:Fruxon.Common.Collections.PageToken.AsString returns this value directly instead of encoding Fruxon.Common.Collections.PageToken.Skip.
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/rosterRoles"{
"items": [
{
"role": "string",
"inCatalog": false,
"holders": [],
"references": []
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Creates or replaces the Application's automatic-enrollment policy.
Full replace. The fallback must be `REQUEST_ACCESS` or `REJECT`, the environment rule must be specified, and the hourly cap at least 1 — anything else is a 400. Applies immediately: senders admitted under `PROVISION` are matched against this policy from the next message on. Save this before flipping an admission select to `PROVISION`; the Network PATCH refuses the enum with no policy in place.
Support KPI rollup for the Application over an optional window (defaults to the last 30 days).
Containment / escalation / degrade / override rates, time-to-human percentiles, live operator load, cost per resolved conversation, and the currently-awaiting-a-human gauge. Rates are null when their denominator is zero. `from`/`to` are Unix ms (half-open); `origin` filters spend only.