FruxonDocs
Agent NetworkGraph

Sets (full replace) the participant's dedicated-operator escalation override.

The participant must already be a served participant of the Network (a customer is granted access before they get dedicated operators) — otherwise `404 Not Found`. 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`. Resolved ahead of the network pool at escalation time. Applies immediately. Returns the updated served-participant row, whose `escalationOverride` echoes the set override.

PUT
/v1/tenants/{tenant}/networks/{network}/participants/{participant}/escalationOverride

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
participant*string

The served participant id the override attaches to.

Formatuuid
tenant*string

The tenant identifier

Request Body

The ordered override ladder + mode.

tiers?|null

This customer's ordered operator ladder, tried ahead of the network default pool. Same shape as the network pool's Fruxon.Model.AgentNetwork.NetworkEscalationPolicy.Tiers; every operator must be an active operator of the network (a customer or external contact can never be an operator).

mode?string

How a per-customer Fruxon.Model.AgentNetwork.EscalationOverride relates to the network's default operator pool (design §17.8).

Value in"UNSPECIFIED" | "PREFERRED" | "EXCLUSIVE"
[key: string]?never

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/participants/497f6eca-6276-4993-bfeb-53cbbbba6f08/escalationOverride" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "00000000-0000-0000-0000-000000000000",
  "networkId": "00000000-0000-0000-0000-000000000000",
  "participantId": "00000000-0000-0000-0000-000000000000",
  "relationshipKey": "SERVED",
  "status": "ACTIVE",
  "source": "MANUAL",
  "agentMode": "ON",
  "escalationOverride": {
    "tiers": [
      {
        "operatorParticipantIds": [],
        "strategy": "UNSPECIFIED"
      }
    ],
    "mode": "PREFERRED",
    "allOperatorParticipantIds": []
  },
  "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
}

Clears the participant's escalation override, reverting to the network default pool.

Removes the dedicated-operator override so this customer's escalations resolve from the network default pool again. Idempotent when no override is set; `404 Not Found` when the participant has no grant in the Network. Applies immediately.

Partially updates a served-participant grant's relationship, status, and/or §17.8 policy.

Set the status to `REVOKED` to withdraw access (soft — the row and its audit survive), retag the relationship, or flip the per-customer agent-mode policy. Omitted fields stay unchanged; no field may carry the UNSPECIFIED sentinel. Applies immediately.