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": "claimed",
"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",
"visitorLastSeq": 6,
"createdAt": "2026-07-12T12:00:00.000Z",
"updatedAt": "2026-07-12T12:00:40.000Z",
"contextPackage": {
"transcriptWindow": [
{
"seq": 5,
"role": "visitor",
"text": "Can I talk to a person about pricing?"
},
{
"seq": 6,
"role": "agent",
"text": "Sure — connecting you to our sales team now."
}
],
"completedActions": [
"identity_verified"
],
"failedActions": [],
"verifiedIdentifiers": {
"email": "visitor@example.com"
}
}
}
}{
"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>"
}
]
}Get an escalation
Fetch one escalation session. The contextPackage (the handoff bundle) is included ONLY when the requesting connector key is the CLAIMING owner; fetching it as the owner extends the activity-based lease. The bundle is free-form but typically carries transcriptWindow (recent turns), completedActions / failedActions (what the AI already did/attempted), and verifiedIdentifiers (identity the AI confirmed) so the human/agent starts fully in context.
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": "claimed",
"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",
"visitorLastSeq": 6,
"createdAt": "2026-07-12T12:00:00.000Z",
"updatedAt": "2026-07-12T12:00:40.000Z",
"contextPackage": {
"transcriptWindow": [
{
"seq": 5,
"role": "visitor",
"text": "Can I talk to a person about pricing?"
},
{
"seq": 6,
"role": "agent",
"text": "Sure — connecting you to our sales team now."
}
],
"completedActions": [
"identity_verified"
],
"failedActions": [],
"verifiedIdentifiers": {
"email": "visitor@example.com"
}
}
}
}{
"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 session id (from listEscalations or the escalation.* webhook).