FruxonDocs
Agent NetworkParticipants

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.

GET
/v1/tenants/{tenant}/participants/consultRoster

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Query Parameters

agentId?string

The agent whose roster to list (required).

PageSize?integer

The maximum number of items to return per page

Formatint32
PageToken.Skip?integer
Formatint32
PageToken.Cursor?string

Opaque 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/participants/consultRoster"
{
  "items": [
    {
      "participantId": "00000000-0000-0000-0000-000000000000",
      "agentId": "string",
      "displayName": "string",
      "kind": "PERSON",
      "roles": [
        "string"
      ],
      "consultAllowed": false,
      "maxUrgency": "LOW",
      "defaultForRoles": [
        "string"
      ],
      "responsePolicy": "ALWAYS",
      "venueBrief": "string"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "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.