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

​
Query Parameters

ParameterTypeRequiredDescription
qstringyesSearch text
limitintegernoMaximum conversations to return, 1-100

​
Response

{
  "conversations": [
    {
      "id": "conv_abc123",
      "title": "Acme renewal planning",
      "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": 1,
  "limit": 20,
  "query": "Acme renewal"
}