Search Dust conversations
Input
query requiredText to look for in conversation titles. Case-insensitive; punctuation is matched literally.
limit optionalMax matches to return (default 30).
Default: 30cursor optionalContinue a previous search: pass the nextCursor from an earlier call.
workspaceId optionalWorkspace sId to search. Omit to use the first workspace on the account.
Output
query requiredThe query actually run, echoed back.
hasMore requirednextCursor requiredPass as `cursor` for the next page; null when hasMore is false.
workspaceId requiredconversations requiredMatching conversations, newest-updated first. Empty means Dust matched nothing for this query — a fact about the query, not an error.
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.
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.