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

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

1{
2  "conversationId": "conv-123",
3  "sessions": [
4    { "id": "sess-A", "startTime": "2026-06-18T14:22:00Z", "status": "COMPLETED" },
5    { "id": "sess-B", "startTime": "2026-06-18T14:40:00Z", "status": "ACTIVE" }
6  ],
7  "nextPageToken": "eyJvZmZzZXQiOjUwfQ=="
8}

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.

DID THIS ARTICLE SOLVE YOUR ISSUE?
Let us know so we can improve!