Get a conversation
Returns conversation messages in chronological order. Pass messageLimit to request a bounded message window. Use id=0 for your cross-scope view.
Requires: scopes:read
Authorizations
A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.
Path Parameters
Numeric scope id. Use 0 for cross-scope conversation lookup.
0
Opaque thread/checkpoint id. The prefix, when present, is not authoritative ownership.
"agent_42_abc-xyz"
Query Parameters
Return at most this many source messages from the conversation detail. Omit to return the full available conversation.
1 <= x <= 10030
Zero-based source-message index before which to load older messages. Requires messageLimit. Omit with messageLimit to load the latest window.
x >= 0120
Response
Opaque thread/checkpoint id. It is not owned by a single scope; a conversation can span multiple workflows.
"agent_42_abc-xyz"
Numeric scope id returned by the list/detail adapter. This is not conversation ownership.
42
Conversation turns, in chronological order.
ISO-8601 timestamp of the first checkpoint for this thread.
"2026-05-01T10:00:00.000Z"
ISO-8601 timestamp of the latest checkpoint for this thread.
"2026-05-01T11:00:00.000Z"
Present only when a bounded message window was requested and honored.