Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "dest_7a2c",
"name": "Sales Hermes (EU)",
"provider": "hermes",
"deliveryMode": "webhook_queue",
"endpointUrl": "https://ops.example.com/flowyte/escalations",
"allowedChannels": [
"chat",
"sms"
],
"capabilities": [
"reply",
"resolve"
],
"contextProfile": "sales",
"transcriptWindow": 20,
"claimSlaSeconds": 90,
"status": "active",
"fallbackRef": "email:sales@example.com",
"createdAt": "2026-06-01T00:00:00.000Z",
"updatedAt": "2026-07-12T10:30:00.000Z"
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Escalation
Update an escalation destination
Partial update — an omitted field is left unchanged. Changing endpointUrl re-validates it (https + SSRF) and resets status to unverified — the new endpoint must re-pass the handshake test before it can route live. Note status can only be set to disabled or unverified here; a destination reaches active ONLY via testEscalationDestination, never a direct PATCH.
PATCH
/
escalation-destinations
/
{id}
Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "dest_7a2c",
"name": "Sales Hermes (EU)",
"provider": "hermes",
"deliveryMode": "webhook_queue",
"endpointUrl": "https://ops.example.com/flowyte/escalations",
"allowedChannels": [
"chat",
"sms"
],
"capabilities": [
"reply",
"resolve"
],
"contextProfile": "sales",
"transcriptWindow": 20,
"claimSlaSeconds": 90,
"status": "active",
"fallbackRef": "email:sales@example.com",
"createdAt": "2026-06-01T00:00:00.000Z",
"updatedAt": "2026-07-12T10:30:00.000Z"
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
Path Parameters
The escalation-destination id (from listEscalationDestinations / createEscalationDestination).
Body
application/json
A partial update — an omitted field is left unchanged. Changing endpointUrl resets status to unverified.
Available options:
chat, sms Available options:
general, sales, support, billing, scheduling Available options:
disabled, unverified