Creates an escalation desk.
`mode` is required and fixed for the desk's life: `BRIDGE` for an operator desk, `NATIVE_HANDOFF` for a console desk (which has no ladder). Every operator on the ladder must be an active operator of the Application — a customer can never be an operator. The new desk is attached nowhere until a channel or the other-conversations slot names it.
Authorization
Bearer JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.
In: header
Path Parameters
The owning Application id.
uuidThe tenant identifier
The desk to create.
What the Application calls the desk, shown wherever a channel names the desk it uses.
The desk's kind. Required on create. On replace, omit it or send the kind the desk already has — a desk cannot change kind; create another desk instead.
"UNSPECIFIED" | "BRIDGE" | "NATIVE_HANDOFF"Operator desk only: the ordered escalation ladder. Every operator must be an active operator of the Application. Empty means nobody is paged: the customer is told someone will follow up and the escalation is logged. Must be empty on a console desk.
Optional fallback reason used when an agent escalates without giving one.
Console desk only: when the agent steps back once the conversation is queued to the console — Fruxon.Model.AgentNetwork.ConsoleMuteTrigger.OnQueued (immediately; default) or Fruxon.Model.AgentNetwork.ConsoleMuteTrigger.OnAssigned (keep helping until a person takes the chat).
"UNSPECIFIED" | "ON_QUEUED" | "ON_ASSIGNED"Console desk only: what Fruxon.Model.AgentNetwork.EscalationDeskRequest.ConsoleMuteTrigger becomes while the team is outside its Fruxon.Model.AgentNetwork.EscalationDeskRequest.WorkingHoursScheduleId hours. Omitted → the same as during working hours.
"UNSPECIFIED" | "ON_QUEUED" | "ON_ASSIGNED"Operator desk only: whether post-hand-back verification and its auto-close backstop run.
Console desk only: whether a console takeover a person has left unanswered past the watchdog's threshold
is handed back to the assistant. Omitted → false, the fail-safe direction.
The working hours of the team this desk reaches. Omitted → none: the team is treated as always available. Must name working hours in this workspace.
uuidResponse Body
curl -X POST "https://api.fruxon.com/v1/tenants/string/networks/497f6eca-6276-4993-bfeb-53cbbbba6f08/escalationDesks" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "00000000-0000-0000-0000-000000000000",
"networkId": "00000000-0000-0000-0000-000000000000",
"name": "string",
"mode": "BRIDGE",
"tiers": [
{
"operatorParticipantIds": [
"00000000-0000-0000-0000-000000000000"
],
"strategy": "FIRST_AVAILABLE"
}
],
"defaultReason": "string",
"consoleMuteTrigger": "ON_QUEUED",
"afterHoursConsoleMuteTrigger": "ON_QUEUED",
"checkBackEnabled": false,
"stalledTakeoverUnmuteEnabled": false,
"workingHoursScheduleId": "00000000-0000-0000-0000-000000000000",
"attachedEntryPointIds": [
"00000000-0000-0000-0000-000000000000"
],
"isOtherConversations": false,
"isArmed": false,
"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
}Deletes an escalation desk.
Refused with `409 Conflict` while a channel or the other-conversations slot names the desk — choose another desk for them, or none, first — or while a conversation handed off through it is still live.
Replaces an escalation desk's settings.
Full replace. `mode` may be omitted; sending the other kind is a `400 Bad Request` — create a new desk instead. Applies immediately, including to conversations already handed off through the desk.