App Logo
dust.tt

Send a Dust message

Send a follow-up message into an existing Dust conversation and wait for the agent's reply (up to 3 minutes). Takes the conversationId from list_conversations, search_conversations or ask. Returns the reply text, the ids of both the sent message and the reply, the agent that answered, and whether generation completed. The agent defaults to "dust"; pass agent to address another one (list_agents). Like ask, this polls rather than streaming, and completed=false means the wait ran out while the agent was still working — the partial reply is returned and the rest can be read later with get_conversation_messages. Only the new reply is returned, not the whole thread: use get_conversation_messages for that.

Input

message required

The message to send.

conversationId required

Conversation sId to post into, e.g. "P35s1dnqSr".

agent optional

Agent sId to address, e.g. "dust". Defaults to "dust".

Default: "dust"
workspaceId optional

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

timeoutSeconds optional

How long to wait for the reply (default 180).

Default: 180

Output

url required
agent required
reply required

The agent's reply as markdown. Null when the agent produced no text (tool-only or errored turn) — a real outcome, not a parse failure.

completed required

False means the wait expired while the agent was still working; the reply is partial.

sentMessageId required

sId Dust gave the message that was sent.

waitedSeconds required
conversationId required
replyMessageId required

sId of the agent's reply.

FAQ

Send a follow-up message into an existing Dust conversation and wait for the agent's reply (up to 3 minutes). Takes the conversationId from list_conversations, search_conversations or ask. Returns the reply text, the ids of both the sent message and the reply, the agent that answered, and whether generation completed. The agent defaults to "dust"; pass agent to address another one (list_agents). Like ask, this polls rather than streaming, and completed=false means the wait ran out while the agent was still working — the partial reply is returned and the rest can be read later with get_conversation_messages. Only the new reply is returned, not the whole thread: use get_conversation_messages for that.
Required: conversationId, message. Optional: agent, workspaceId, timeoutSeconds.
It returns url, agent, reply, completed, sentMessageId, waitedSeconds, conversationId, replyMessageId.
Yes. It acts as you on dust.tt: on your own Chrome it reuses your session, and on a Reduck-hosted browser it loads the dust.tt cookies saved by the Reduck extension.
It makes changes on dust.tt, like sending, posting or booking something.
Ask an AI agent connected to Reduck to run reduck/dust.tt/send_message, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/dust.tt/send_message
It is part of Reduck's official curated catalogue.

Related scripts

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). 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.

dust.tt

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.

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.

Start building not clicking

Get started for free