Searches enrollable-operator candidates for the Add-operator picker.
A DB-paged, name-searchable page of curated directory Persons who could be enrolled as an operator here, each flagged with `servedHere` (an active served-participant/customer grant in this Network → not operator-eligible, per the operator/customer mutual exclusion). People already enrolled as operators are excluded. This backs the picker's server-side type-ahead so it no longer loads the whole tenant directory or the whole served set. Classification of the rest (external vs internal vs promotable) is done client-side from the returned audience / tier; the enroll write path still rejects an ineligible pick with `400`. The literal `candidates` segment out-ranks the `{operator}` route, so there is no collision.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The owning Network id.
uuidThe tenant identifier
Query Parameters
Case-insensitive display-name substring; null / blank returns the first page unfiltered.
The maximum number of items to return per page
int32int32Opaque 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/operators/candidates"{
"items": [
{
"participantId": "00000000-0000-0000-0000-000000000000",
"displayName": "string",
"kind": "PERSON",
"audience": "UNKNOWN",
"tier": "CURATED",
"disabledAt": 0,
"servedHere": false
}
],
"nextPageToken": "string",
"totalCount": 0
}{
"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.