Sessions

List the conversation

Returns the Session's conversation in order: the opening prompt, each message in it afterwards, and one reply for every finished turn. kind tells them apart. A reply's content is the turn's result_summary (empty when the turn left none), with the turn's status and outcome beside it, so a failed or cancelled turn is listed and marked as such; a structured result the agent declared is result on getSession, and a turn's intermediate text and tool activity are events (listSessionEvents). A reply is listed once every turn before it has finished. Delivery notes are not included. Cursor-paginated: pass end_cursor as after, and keep polling with it to receive what is said next. An item's cursor belongs to this list only and is not a message seq.

<sub>Scope: sessions:read</sub>

get/v3/organizations/{orgId}/sessions/{sessionId}/conversation

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/sessions/{sessionId}/conversation
  • Auth: HTTP bearer

Query parameters

firstinteger

Page size (default 50, max 200).

afterstring

Cursor from a previous page's end_cursor (or an item's cursor): return only what follows it.

Response

A page of the conversation.

has_next_pageboolean required
end_cursorstring nullable required

The cursor of the last item, or the after that was sent when the page is empty; null only when nothing has been read. Keep polling with it after has_next_page is false to receive what is said next.

Changes

No recorded changes to this operation across all 1 revision of this API.