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.
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
The participant to enroll and optional role keys / pool.
The Fruxon.Model.Participants.Participant to enroll. Must be operator-eligible.
uuidOptional free-form operator role keys (e.g. "tier1", "billing"). Empty by default. Stored generally for forward-compatible role-targeted pools; V1 escalation resolves ordered-fallback only.
Optional named pool this operator belongs to (forward-compat; deferred). Null = not pooled.
Response Body
curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/operators" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "00000000-0000-0000-0000-000000000000",
"networkId": "00000000-0000-0000-0000-000000000000",
"participantId": "00000000-0000-0000-0000-000000000000",
"status": "ACTIVE",
"presence": "AVAILABLE",
"presenceChangedAt": 0,
"presenceNote": "string",
"activeConversationCount": 0,
"roleKeys": [
"string"
],
"poolKey": "string",
"createdAt": 0,
"modifiedAt": 0
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}{
"type": "string",
"title": "string",
"status": 0,
"detail": "string",
"instance": "string",
"property1": null,
"property2": null
}Partially updates an operator's live status, presence, role keys, and/or pool.
Live drain/disable, presence, and retagging: set the status to `DISABLED` to drain the operator, set the presence to `AWAY` to mark them stepped-away (both skip the operator in escalation resolution; the row and its role keys / pool survive so re-activating restores it), replace the role keys, or set/clear the pool. Omitted fields stay unchanged. Applies immediately.
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.