App Logo
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.

Input

query required

Text to look for in conversation titles. Case-insensitive; punctuation is matched literally.

limit optional

Max matches to return (default 30).

Default: 30
cursor optional

Continue a previous search: pass the nextCursor from an earlier call.

workspaceId optional

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

Output

query required

The query actually run, echoed back.

hasMore required
nextCursor required

Pass as `cursor` for the next page; null when hasMore is false.

workspaceId required
conversations required

Matching conversations, newest-updated first. Empty means Dust matched nothing for this query — a fact about the query, not an error.

FAQ

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.
Required: query. Optional: limit, cursor, workspaceId.
It returns query, hasMore, nextCursor, workspaceId, conversations.
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 only reads. It looks things up on dust.tt and changes nothing there.
Ask an AI agent connected to Reduck to run reduck/dust.tt/search_conversations, or run it from a terminal with the Reduck CLI: npx @reduck-ai/cli@latest run --script reduck/dust.tt/search_conversations
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

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.

dust.tt

List Dust conversations

List the signed-in Dust workspace's conversations, newest first. Returns workspaceId and conversations (sId, title, created, updated, unread, hasError, actionRequired, isRunningAgentLoop, spaceId), plus hasMore and nextCursor for paging. sId is the join key for get_conversation_messages. Pass workspaceId to target a specific workspace when the account belongs to several; it defaults to the first workspace on the account. Paginate with cursor (pass back the nextCursor you were given) rather than an offset — the list is ordered by last update, so an offset would skip or repeat rows as conversations move. Requires being signed in to dust.tt.

Start building not clicking

Get started for free