Skip to main content
GET
Get a conversation

Authorizations

Authorization
string
header
required

A Modus personal access token (modus_<orgUuid>_<prefix>_<secret>) or an OAuth 2.1 access token, sent as Authorization: Bearer <token>.

Path Parameters

id
number
required

Numeric scope id. Use 0 for cross-scope conversation lookup.

Example:

0

threadId
string
required

Opaque thread/checkpoint id. The prefix, when present, is not authoritative ownership.

Example:

"agent_42_abc-xyz"

Query Parameters

messageLimit
number

Return at most this many source messages from the conversation detail. Omit to return the full available conversation.

Required range: 1 <= x <= 100
Example:

30

beforeMessageIndex
number

Zero-based source-message index before which to load older messages. Requires messageLimit. Omit with messageLimit to load the latest window.

Required range: x >= 0
Example:

120

Response

threadId
string
required

Opaque thread/checkpoint id. It is not owned by a single scope; a conversation can span multiple workflows.

Example:

"agent_42_abc-xyz"

scopeId
number
required

Numeric scope id returned by the list/detail adapter. This is not conversation ownership.

Example:

42

messages
object[]
required

Conversation turns, in chronological order.

createdAt
string
required

ISO-8601 timestamp of the first checkpoint for this thread.

Example:

"2026-05-01T10:00:00.000Z"

updatedAt
string
required

ISO-8601 timestamp of the latest checkpoint for this thread.

Example:

"2026-05-01T11:00:00.000Z"

messageWindow
object

Present only when a bounded message window was requested and honored.