App Logo
dust.tt

Get Dust conversation messages

Read a Dust conversation's messages by conversation sId (from list_conversations or search_conversations), oldest first. Returns workspaceId, conversationId, title, a truncated flag, and messages: each with sId, role (user or agent), content, created, rank, plus author (the human's name/email on a user turn) and agent (the mentioned agent's id on an agent turn). The endpoint pages newest-first from the end of the conversation; this script walks that cursor backwards until it has the whole history or hits `limit`, then returns the messages in reading order. truncated is true when limit stopped it before the first message, so the oldest turns are missing. An unknown conversation id fails loudly rather than returning an empty transcript. Requires being signed in to dust.tt.

Input

conversationId required

Conversation sId, e.g. "P35s1dnqSr" — from list_conversations or search_conversations.

limit optional

Max messages to return (default 200). The newest are kept when a conversation is longer.

Default: 200
workspaceId optional

Workspace sId. Omit to use the first workspace on the account.

Output

title required

Conversation title, null when Dust has not titled it yet.

messages required

Oldest first — reading order.

truncated required

True when `limit` cut the history short, so the oldest messages are not included.

workspaceId required
conversationId required

Start building not clicking