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.
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 operator participant id.
uuidThe tenant identifier
The status / role-key / pool changes.
When present, sets the live drain/disable status (ACTIVE or DISABLED). UNSPECIFIED is rejected.
"UNSPECIFIED" | "ACTIVE" | "DISABLED"When present, sets the operator's self-service presence (AVAILABLE or AWAY). UNSPECIFIED is rejected. When supplied, Fruxon.Model.AgentNetwork.PatchNetworkOperatorRequest.PresenceNote is applied alongside it (blank clears the note).
"UNSPECIFIED" | "AVAILABLE" | "AWAY"Optional note to store when going AWAY (e.g. "on vacation"). Applied only when Fruxon.Model.AgentNetwork.PatchNetworkOperatorRequest.Presence is set.
When present, replaces the operator's role keys (send [] to clear them). Null = unchanged.
When present (and Fruxon.Model.AgentNetwork.PatchNetworkOperatorRequest.ClearPoolKey is false), sets the named pool. Blank is treated as null. Null = unchanged.
When true, clears the pool (un-pools the operator). Takes precedence over Fruxon.Model.AgentNetwork.PatchNetworkOperatorRequest.PoolKey.
Response Body
curl -X PATCH "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/operators/497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "00000000-0000-0000-0000-000000000000",
"networkId": "00000000-0000-0000-0000-000000000000",
"participantId": "00000000-0000-0000-0000-000000000000",
"displayName": "string",
"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
}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.
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.