FruxonDocs
Agent NetworkGraph

Searches enrollable-operator candidates for the Add-operator picker.

A paged, name-searchable list of curated directory people who could be enrolled as an operator here, each with the server's verdict: `status` (`ELIGIBLE`, `PROMOTABLE` when enrolling first classifies them as internal, or `INELIGIBLE`) and, when ineligible, a stable `ineligibleReason` code. Existing operators, external customers, disabled people, groups and ambient identities are excluded, so in practice every row is selectable. Being served in this Application does not make someone ineligible: an internal teammate may be served and be an operator at once, and the `servedHere` flag reports it for display only. The verdict applies the same rule as enrollment, so a selectable candidate is one `POST` accepts.

GET
/v1/tenants/{tenant}/networks/{network}/operators/candidates

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

query?string

Case-insensitive display-name substring; null / blank returns the first page unfiltered.

PageSize?integer

The maximum number of items to return per page

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

Opaque pagination token returned by an external service. Pass it back unchanged rather than interpreting it as an offset.

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/operators/candidates"
{
  "items": [
    {
      "participantId": "00000000-0000-0000-0000-000000000000",
      "displayName": "string",
      "kind": "PERSON",
      "audience": "UNKNOWN",
      "tier": "CURATED",
      "disabledAt": 0,
      "servedHere": false,
      "status": "ELIGIBLE",
      "ineligibleReason": "NOT_PERSON"
    }
  ],
  "nextPageToken": "string",
  "totalCount": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Lists the Network's operator directory.

Returns every enrolled operator in the Network (active and disabled), in participant order. The set is small and slow-changing, so it is returned as one page.

Removes an operator from the Network directory.

Drops the operator from the directory entirely. Escalation ladders that still reference the participant degrade gracefully (the operator is skipped during the ladder walk). Removing a participant that is not an enrolled operator yields `404 Not Found`. To keep the row but stop offering escalations, PATCH the status to `DISABLED` instead. Applies immediately.