FruxonDocs
Agent NetworkGraph

Projects the Network's people with their composable role badges and provenance.

Returns every participant that holds any live relationship in the Network — an active access grant, an active operator membership, or a consult-allowed member edge — with their additive role badges. Each badge exposes the source relationship (access grant / operator membership / member relation) that granted it, so the UI can render "why" and offer a narrow, badge-scoped revoke. Pass badge to filter to one composable view (`CUSTOMER`, `INTERNAL`, `OBSERVER`, `OPERATOR`, `ADVISOR`, or `CHANNEL`); the returned counts always reflect the full projection so every tab shows its total.

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

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

badge?string

Optional composable-view filter; omit for the full projection.

Value in"UNSPECIFIED" | "CUSTOMER" | "INTERNAL" | "OBSERVER" | "OPERATOR" | "ADVISOR" | "CHANNEL"
search?string

Optional case-insensitive substring filter on the participant display name.

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/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/people"
{
  "items": [
    {
      "participantId": "00000000-0000-0000-0000-000000000000",
      "displayName": "string",
      "kind": "PERSON",
      "audience": "UNKNOWN",
      "tier": "CURATED",
      "area": "string",
      "avatarFileId": "string",
      "disabledAt": 0,
      "expertise": [
        "string"
      ],
      "agentMode": "ON",
      "escalationOverride": {
        "tiers": [],
        "mode": "UNSPECIFIED",
        "allOperatorParticipantIds": []
      },
      "badges": []
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Grants a participant access to the Network.

The participant must exist and be a Person or Group; an AI agent is a member/peer and yields `400 Bad Request`. Idempotent: re-granting an existing participant re-applies its relationship and §17.8 policy and re-activates a revoked grant. Applies immediately.

Creates a new, non-default Network.

Creates an operator-facing Network (never the Default). The new Network starts empty; assign agents as members to it. Applies immediately.