Lists an agent's consult roster — its bound participants with consult metadata.
Returns one row per participant bound to agentId, each carrying the consult-roster fields (roles, consult-allowed, urgency cap, default-for-roles) that drive `consult_for_role` resolution and the consult policy gate (design §12). The Consult Network UI renders + edits this list.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The tenant identifier
Query Parameters
The agent whose roster to list (required).
Response Body
curl -X GET "https://api.fruxon.com/v1/tenants/string/participants/consultRoster"{
"items": [
{
"participantId": "00000000-0000-0000-0000-000000000000",
"agentId": "string",
"displayName": "string",
"kind": "PERSON",
"roles": [
"string"
],
"consultAllowed": false,
"maxUrgency": "LOW",
"defaultForRoles": [
"string"
]
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Patches the consult-roster metadata on one participant↔agent binding.
PATCH semantics: null fields are left unchanged; a supplied list replaces the stored one. `default_for_roles` must be a subset of `roles`. The `binding` route segment is the agent id (consistent with the bind sub-resource). 404 if the binding doesn't exist.
Deletes a participant and all its bindings.
Permanently removes the participant along with every agent binding attached to it. The delete does not cascade to the agents themselves. Returns 404 when the participant does not exist.