Skip to main content
GET
/
api
/
v1
/
conversations
List Conversations
curl --request GET \
  --url https://api.example.com/api/v1/conversations

​
Query Parameters

ParameterTypeDescription
limitintegerPage size, 1-100
offsetintegerNumber of conversations to skip
agent_idstringOptional agent filter
all_usersbooleanInclude tenant-wide conversations. Requires source_ref_id.
source_ref_idstringFilter by source reference, typically a playbook UUID in conversation metadata
sourcestringOptional source filter
exclude_sourcestringOptional source exclusion

​
Response

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Q4 Sales Analysis",
      "agent_id": "agent_abc123",
      "created_at": "2026-03-15T10:00:00Z",
      "updated_at": "2026-03-15T10:30:00Z",
      "is_active": true,
      "source": null,
      "source_id": null,
      "source_metadata": null,
      "last_read_at": null,
      "message_count": 12,
      "has_active_generation": false
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}