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

ParameterRequiredDescription
conversationIdYesConversation identifier.
ParameterRequiredDescription
owner_idYesEnd-user’s Individual ID.
owner_typeYesOwner type (for example, individual).
statusNoFilter by session status.
time_rangeNoFilter by time range.
fieldsNoProjection list. Repeat parameter for multiple fields.
participant_idNoFilter by participant ID.
page_tokenNoPagination token for retrieving next page.
HeaderRequiredDescription
AuthorizationYesBearer JWT token.
agent_idYesAgent identifier.
FieldTypeDescription
conversationIdStringParent conversation identifier.
sessionsArrayList of session summary items.
sessions[].idStringSession identifier.
sessions[].startTimeString (ISO 8601)Session start time.
sessions[].statusStringSession status.
nextPageTokenStringPagination token. Present if more results exist.

Status: 200 OK

Status CodeDescription
400Bad Request. Invalid query parameters.
401Unauthorized. Invalid or missing JWT token.
404Not Found. Conversation does not exist.
500Internal Server Error.