List Sessions
Returns a filtered, lightweight index of sessions for a given conversation.
URI: /api/v1/agentic/conversations/{conversationId}/sessions
HTTP Method: GET
Authentication: Bearer JWT
| Parameter | Required | Description |
|---|---|---|
| conversationId | Yes | Conversation identifier. |
| Parameter | Required | Description |
|---|---|---|
| owner_id | Yes | End-user’s Individual ID. |
| owner_type | Yes | Owner type (for example, individual). |
| status | No | Filter by session status. |
| time_range | No | Filter by time range. |
| fields | No | Projection list. Repeat parameter for multiple fields. |
| 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 |
|---|---|---|
| conversationId | String | Parent conversation identifier. |
| sessions | Array | List of session summary items. |
| sessions[].id | String | Session identifier. |
| sessions[].startTime | String (ISO 8601) | Session start time. |
| sessions[].status | String | Session status. |
| 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. |
| 404 | Not Found. Conversation does not exist. |
| 500 | Internal Server Error. |