FruxonDocs
Agent NetworkGraph

Replaces the Network's escalation operator ladder.

Full replace. Every operator must be an active operator of the Network (enroll them via the operators directory first); an unknown or non-operator participant yields `400 Bad Request` — a customer can never be an operator. An empty ladder clears the pool (members keep the conversation and degrade gracefully when they escalate). Applies immediately.

PUT
/v1/tenants/{tenant}/networks/{network}/escalationPolicy

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

Request Body

The escalation ladder to set.

tiers?|null

The ordered escalation ladder. Every operator must be an active operator of the network.

defaultReason?string|null

Optional fallback reason used when a member escalates without giving one.

mode?string

How a human escalation is delivered once an operator is chosen — the coarse "who owns the live conversation" switch, orthogonal to which operators are on call (Fruxon.Model.ConversationBridges.EscalationTier).

Value in"UNSPECIFIED" | "BRIDGE" | "NATIVE_HANDOFF"
consoleMuteTrigger?string

For a console-routed escalation (TexterChat and future consoles), when the member agent steps back once the conversation is handed to the source console's human queue — relative to that console's own queue lifecycle. Orthogonal to which operators are on call and to the Bridge delivery mode (where Fruxon relays and there is no console to defer to). See console-routed-handoff-phase3-plan-2026-07-11.md.

Value in"UNSPECIFIED" | "ON_QUEUED" | "ON_ASSIGNED"
[key: string]?never

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/escalationPolicy" \  -H "Content-Type: application/json" \  -d '{}'
{
  "networkId": "00000000-0000-0000-0000-000000000000",
  "tiers": [
    {
      "operatorParticipantIds": [
        "00000000-0000-0000-0000-000000000000"
      ],
      "strategy": "FIRST_AVAILABLE"
    }
  ],
  "defaultReason": "string",
  "mode": "BRIDGE",
  "consoleMuteTrigger": "ON_QUEUED",
  "resolutionMode": "OFF",
  "doorways": [
    {
      "provider": "string",
      "supportsNativeHandoff": false
    }
  ],
  "createdAt": 0,
  "modifiedAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Returns the Network's escalation pool (an empty pool when none is set).

Returns the live operator ladder the escalation tool uses for members of this Network. The `resolutionMode` badge is always `ON` — this pool (and per-customer overrides) is the resolution source. No pool yet returns an empty ladder so clients can render the editor. Changes take effect without publishing a new Network revision.

Returns a Network and its member roster.

Returns the Network plus its stable memberships, each with its live release pin and operational status.