Returns a filtered, lightweight index of conversations owned by a given user. Returns only conversation-level summary rows, not the full data graph.
URI: /api/v1/agentic/conversations
HTTP Method: GET
Authentication: Bearer JWT
Query Parameters
| Parameter | Required | Description |
|---|---|---|
| owner_id | Yes | End-user's Individual ID. |
| owner_type | Yes | Owner type (for example, individual). |
| status | No | Filter by conversation status. |
| time_range | No | Filter by time range. |
| fields | No | Projection list. Repeat parameter for multiple fields: fields=id&fields=name. |
| participant_id | No | Filter by participant ID. |
| page_token | No | Pagination token for retrieving next page. |
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| agent_id | Yes | Agent identifier. |
Response Body Schema
| Field | Type | Description |
|---|---|---|
| conversations | Array | List of conversation summary items. |
| conversations[].id | String | Conversation identifier. |
| conversations[].startTime | String (ISO 8601) | Conversation start time. |
| conversations[].status | String | Conversation status. |
| conversations[].name | String | Conversation name. |
| conversations[].modifiedDate | String (ISO 8601) | Last modified date. |
| nextPageToken | String | Pagination token. Present if more results exist. |
Example Response
Status: 200 OK
{
"conversations": [
{
"id": "conv-123",
"startTime": "2026-06-18T14:22:00Z",
"status": "ACTIVE",
"name": "Support chat — order #4471",
"modifiedDate": "2026-06-18T14:55:00Z"
}
],
"nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
}
Error Codes
| Status Code | Description |
|---|---|
| 400 | Bad Request. Invalid query parameters. |
| 401 | Unauthorized. Invalid or missing JWT token. |
| 500 | Internal Server Error. |