List agent conversations
Return the agent conversations accessible to the API key in its project, ordered by last-updated time from newest to oldest. A conversation is accessible when it belongs to the key's creator; conversations belonging to other users are not accessible regardless of the creator's project role. Subagent conversations are excluded from the list but can still be read directly by id. Supplying a query matches conversation titles, user-authored text, assistant response text, tool names, and tool statuses. Results are cursor-paginated: pass the returned next_cursor back unchanged, with the same query and page_size, for the following page. Returns an empty list when nothing matches.
Return the agent conversations accessible to the API key in its project, ordered by last-updated time from newest to oldest. A conversation is accessible when it belongs to the key's creator; conversations belonging to other users are not accessible regardless of the creator's project role. Subagent conversations are excluded from the list but can still be read directly by id. Supplying a query matches conversation titles, user-authored text, assistant response text, tool names, and tool statuses. Results are cursor-paginated: pass the returned next_cursor back unchanged, with the same query and page_size, for the following page. Returns an empty list when nothing matches.
Authorization
ApiKeyAuth External API key header (format: sofa-ext-). Authorization: Bearer is also accepted.
In: header
Query Parameters
Regular expression matched case-insensitively against conversation titles, user text, assistant text, tool names, and tool statuses.
Number of conversations per page.
1 <= value <= 10020Opaque cursor from a previous response's next_cursor.
Response Body
application/json
application/json
curl -X GET "https://example.com/v2/external-api/agent_conversations"{ "items": [ { "object": "agent_conversation", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "origin": "user", "title": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z", "automation": { "object": "agent_conversation_automation_run", "automation_id": "64fb5f73-6415-4f56-8e9e-ca06539f09ac", "automation_name": "string", "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec", "run_status": "scheduled", "run_started_at": "2019-08-24T14:15:22Z", "run_completed_at": "2019-08-24T14:15:22Z" } } ], "next_cursor": "string"}