Returns a filtered, lightweight index of sessions for a given conversation.
URI: /api/v1/agentic/conversations/{conversationId}/sessions
HTTP Method: GET
Authentication: Bearer JWT
Path Parameters
| Parameter | Required | Description |
|---|---|---|
| conversationId | Yes | Conversation identifier. |
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 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. |
Request Headers
| Header | Required | Description |
|---|---|---|
| Authorization | Yes | Bearer JWT token. |
| agent_id | Yes | Agent identifier. |
Response Body Schema
| 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. |
Example Response
Status: 200 OK
{
"conversationId": "conv-123",
"sessions": [
{ "id": "sess-A", "startTime": "2026-06-18T14:22:00Z", "status": "COMPLETED" },
{ "id": "sess-B", "startTime": "2026-06-18T14:40:00Z", "status": "ACTIVE" }
],
"nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
}
Error Codes
| 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. |