FruxonDocs
Agent NetworkGraph

Lists a page of the Network's served-participant grants.

Returns a page of access grants in the Network (served, observer, and advisor; active and revoked), in participant order. Paged at the DB with no total-count query — items + next-page cursor only.

GET
/v1/tenants/{tenant}/networks/{network}/participants

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Path Parameters

network*string

The owning Network id.

Formatuuid
tenant*string

The tenant identifier

Query Parameters

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.

includeTotalCount?boolean

Opt in to the one extra COUNT that fills totalCount (default off).

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/participants"
{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "networkId": "00000000-0000-0000-0000-000000000000",
      "participantId": "00000000-0000-0000-0000-000000000000",
      "relationshipKey": "SERVED",
      "status": "ACTIVE",
      "source": "MANUAL",
      "agentMode": "ON",
      "escalationOverride": {
        "tiers": [],
        "mode": "UNSPECIFIED",
        "allOperatorParticipantIds": []
      },
      "createdAt": 0,
      "modifiedAt": 0
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Enrolls a participant as an operator of the Network.

The participant must satisfy the operator-eligibility predicate — an internal, curated person that is not disabled; a customer, group, AI peer, or disabled person yields `400 Bad Request`. Idempotent: re-enrolling an existing operator (re)applies its role keys / pool and re-activates it. Applies immediately.

Removes a participant from the Network ("Remove from application").

Archives the grant (soft delete): the row is kept and flipped to `REMOVED` with removed-by/-at provenance, and its Layer-2 wiring is torn down, so the participant is treated as a new contact on their next inbound message while the archived row survives for audit and returning-customer recognition. Removing a participant that has no grant yields `404 Not Found`. This is <em>not</em> a durable keep-out — a re-grant or directory re-import revives the row. To keep the participant on the roster but stop serving them, PATCH the status to `REVOKED` (Block) instead. Applies immediately.