List Conversations
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
| 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. |
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| agent_id | Yes | Agent identifier. |
| 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. |
Status: 200 OK
| Status Code | Description |
|---|---|
| 400 | Bad Request. Invalid query parameters. |
| 401 | Unauthorized. Invalid or missing JWT token. |
| 500 | Internal Server Error. |