Ask Dust
Input
question requiredThe question to send as the first message of a new conversation.
agent optionalAgent sId to ask, e.g. "dust" (general purpose) or "helper" (help on using Dust). Defaults to "dust".
Default: "dust"workspaceId optionalWorkspace sId to create the conversation in. Omit to use the first workspace on the account.
timeoutSeconds optionalHow long to wait for the agent to finish (default 180).
Default: 180Output
url requiredLink to the conversation in the Dust web app.
agent requiredThe agent that answered, as its sId.
answer requiredThe agent's answer as the markdown it emitted. Null when the agent produced no text at all — which happens on a tool-only or errored turn and is a real outcome, not a parse failure.
completed requiredTrue when the agent's turn finished inside the timeout. False means the answer is partial — re-read it later with get_conversation_messages.
messageId requiredsId of the agent's message.
waitedSeconds requiredHow long the poll actually waited before returning.
conversationId requiredConversation sId — the join key for get_conversation_messages.
userMessageId optionalsId of the question as Dust stored it.
Search Dust conversations
Search the signed-in Dust workspace's conversations by title text. Returns workspaceId and the matching conversations (sId, title, created, updated, spaceName), newest-updated first, with hasMore and nextCursor. sId is the join key for get_messages. The search covers conversation titles, not message bodies, so a word spoken inside a chat will not match unless it is also in the title — and Dust titles conversations automatically, so titles are paraphrases of the opening message. An empty match list is a real answer about the query, not a failure. Requires being signed in to dust.tt.
List Dust agents
List the agents available in the signed-in Dust workspace. Returns workspaceId and agents (sId, name, description, scope, status, model provider/id, userFavorite, canEdit, tags). sId is what you pass as `agent` to ask or send_message. Scope tells you where an agent comes from: "global" is a Dust built-in such as dust, helper, deep-dive or analyst, "workspace"/"published" is one your workspace created, "hidden"/"private" is personal. Requires being signed in to 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.