Error

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",
    "isTest": false,
    "responseDeadlineAt": "2026-07-12T12:02:00.000Z",
    "leaseExpiresAt": "2026-07-12T12:02:30.000Z",
    "createdAt": "2026-07-12T12:00:00.000Z",
    "updatedAt": "2026-07-12T12:00:50.000Z",
    "contextPackage": {
      "transcriptWindow": [
        {
          "seq": 5,
          "role": "visitor",
          "text": "Can I talk to a person about pricing?"
        }
      ],
      "completedActions": [
        "identity_verified"
      ],
      "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>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Escalation

Claim an escalation

Claim a requested/notified escalation, setting a per-channel activity-based lease. Idempotent for the SAME key (re-claim extends the lease); a claim by a DIFFERENT key returns 409 claim_conflict. The claim preconditions are revalidated at claim time: the destination’s AI-Harness integration must still be connected and — unless the session is a handshake test — the destination must still be active, else 409 destination_unavailable (the pre-claim SLA sweeper still fires the fallback so the visitor is not stranded). The returned contextPackage.transcriptWindow is rebuilt at claim so the claimer starts current with any turns forwarded between requested and claimed. Requires the org to be on a Starter plan or higher.

POST

escalations

{id}

claim

Error

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",
    "isTest": false,
    "responseDeadlineAt": "2026-07-12T12:02:00.000Z",
    "leaseExpiresAt": "2026-07-12T12:02:30.000Z",
    "createdAt": "2026-07-12T12:00:00.000Z",
    "updatedAt": "2026-07-12T12:00:50.000Z",
    "contextPackage": {
      "transcriptWindow": [
        {
          "seq": 5,
          "role": "visitor",
          "text": "Can I talk to a person about pricing?"
        }
      ],
      "completedActions": [
        "identity_verified"
      ],
      "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>"
    }
  ]
}

{
  "type": "about:blank",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "instance": "<string>",
  "code": "<string>",
  "errors": [
    {
      "field": "<string>",
      "message": "<string>"
    }
  ]
}

Authorizations

Authorization

string

header

required

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

string

required

The escalation session id to claim.

Response

The claimed escalation (includes the contextPackage for the owner, rebuilt at claim).

success

boolean

required

data

object

required

Show child attributes

message

string

errors

object[]

Show child attributes

Post a harness reply to the visitor Extend the claim lease

Using the API

Endpoints

Claim an escalation

Authorizations

Path Parameters

Response