A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "esc_9f21",
"conversationId": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"destinationId": "dest_7a2c",
"channel": "chat",
"state": "active",
"reason": {
"type": "explicit_request",
"summary": "Visitor asked to speak with sales."
},
"isTest": false,
"responseDeadlineAt": "2026-07-12T12:02:00.000Z",
"leaseExpiresAt": "2026-07-12T12:01:30.000Z",
"createdAt": "2026-07-12T12:00:00.000Z",
"updatedAt": "2026-07-12T12:00:40.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}{
"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>"
}
]
}List escalations
List the org’s escalation sessions (newest first). The handoff context package is NEVER included in the list — fetch a single escalation as its claiming owner to receive it.
A valid request URL is required to generate request examples{
"success": true,
"data": [
{
"id": "esc_9f21",
"conversationId": "conv_9d2f01",
"agentId": "agt_4f9c2b7e10a24d51",
"destinationId": "dest_7a2c",
"channel": "chat",
"state": "active",
"reason": {
"type": "explicit_request",
"summary": "Visitor asked to speak with sales."
},
"isTest": false,
"responseDeadlineAt": "2026-07-12T12:02:00.000Z",
"leaseExpiresAt": "2026-07-12T12:01:30.000Z",
"createdAt": "2026-07-12T12:00:00.000Z",
"updatedAt": "2026-07-12T12:00:40.000Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
}
}{
"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.
Query Parameters
1-based page number for offset pagination. Defaults to 1 (the first page).
x >= 1Page size — how many items to return per page (1–100). Defaults to 20.
1 <= x <= 100Filter by session state. One of: requested, notified, claimed, active, resolved, returned, human_takeover, expired, fallback_started, fallback_completed, cancelled, claim_failed.
requested, notified, claimed, active, resolved, returned, human_takeover, expired, fallback_started, fallback_completed, cancelled, claim_failed Filter to escalations routed to one destination.