JawblyJawblyDocs
API reference

Conversations

The threads between your assistant and each customer, including handoff state so your own tools can take over.

Base URLhttps://api.jawbly.com/v1
For agents: llms.txt·OpenAPI
GET List conversationsPOST Hand off to a human
GET/conversations

List conversations

List conversations for your business, filterable by status and assignee.

Requires scope conversations:read

Parameters

status
"open" | "handoff" | "closed" · query

Filter by conversation state.

contactId
string · query

Only conversations with this contact.

curl -X GET "https://api.jawbly.com/v1/conversations" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx"
200 response
{
  "data": [
    {
      "id": "conv_8fA1…",
      "contactId": "ct_5m…",
      "status": "open",
      "lastInboundAt": "2026-07-07T10:10:00Z"
    }
  ],
  "nextCursor": null
}
POST/conversations/{conversationId}/handoff

Hand off to a human

Pause the assistant on a conversation and mark it for a human agent, e.g. from your own inbox.

Requires scope conversations:write

Parameters

conversationIdrequired
string · path

The conversation to hand off.

curl -X POST "https://api.jawbly.com/v1/conversations/{conversationId}/handoff" \
  -H "Authorization: Bearer jwb_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{}'
200 response
{
  "id": "conv_8fA1…",
  "status": "handoff"
}
MessagesContacts