# Dust Docs Documentation > Dust's documentation, user guides, and developer platform. ## Guides - [Intro to Dust](https://docs.dust.tt/docs/intro.md): What is Dust and how to use the platform - [Dust Rollout Guide](https://docs.dust.tt/docs/dust-enterprise-rollout-guide.md) - [Welcome to Dust](https://docs.dust.tt/docs/welcome-to-dust.md) - [Launch strategy](https://docs.dust.tt/docs/launch-strategy.md) - [Team Onboarding Material](https://docs.dust.tt/docs/training-material.md) - [Build your builders community](https://docs.dust.tt/docs/build-your-builder-community.md) - [Admin guide: set up your Dust workspace](https://docs.dust.tt/docs/admin-guide-set-up-your-dust-workspace.md) - [Designing use cases](https://docs.dust.tt/docs/designing-use-cases.md) - [Educate & activate](https://docs.dust.tt/docs/educate-activate.md) - [Measure & expand](https://docs.dust.tt/docs/measure-expand.md) - [Use Cases & Guides](https://docs.dust.tt/docs/use-cases.md): Discover Dust use cases for your team, and build them! - [🤝 Sales](https://docs.dust.tt/docs/dust-for-sales.md): How to use Dust for Sales Teams - [🏆 Customer Support](https://docs.dust.tt/docs/customer-support.md): How to use Dust for Customer Support Teams - [🎯 Marketing](https://docs.dust.tt/docs/marketing-content.md): Dust use cases for marketing and content - [🤖 Engineering](https://docs.dust.tt/docs/engineering.md): How to use Dust for Engineering Teams - [📈 Data Analytics](https://docs.dust.tt/docs/data-analysis.md): Dust use cases for data teams. - [📖 Knowledge](https://docs.dust.tt/docs/dust-for-knowledge-management.md): How to use Dust for knowledge-management use cases - [👥 Recruiting & People](https://docs.dust.tt/docs/recruiting-hr.md): How to use Dust for Recruiter & HR Teams - [📦 Product & Design](https://docs.dust.tt/docs/product.md): How to use Dust for Product & Design Teams - [Collaboration](https://docs.dust.tt/docs/collaboration.md) - [FAQ](https://docs.dust.tt/docs/faq.md) - [I don’t know how to start creating an agent; what should I do?](https://docs.dust.tt/docs/i-dont-know-how-to-start-creating-an-agent-what-should-i-do.md) - [How do I edit a custom agent?](https://docs.dust.tt/docs/how-do-i-edit-a-custom-agent.md) - [What settings / model should I use?](https://docs.dust.tt/docs/what-settings-model-should-i-use.md) - [Can agents create a new file or document directly into Notion, Google Drive, or other connected platforms?](https://docs.dust.tt/docs/can-agents-create-a-new-file-or-document-directly-into-notion-google-drive-or-other-connected-platforms.md) - [What data do the agents have access to?](https://docs.dust.tt/docs/what-data-do-the-agents-have-access-to.md) - [Do the agents have access to the Internet?](https://docs.dust.tt/docs/do-the-agents-have-access-to-the-internet.md) - [Does the Dust agent give accurate and safe responses?](https://docs.dust.tt/docs/does-the-dust-agent-give-accurate-and-safe-responses.md) - [Is there a Dust conversation API?](https://docs.dust.tt/docs/is-there-a-dust-conversation-api.md) - [Can I share a conversation?](https://docs.dust.tt/docs/can-i-share-a-conversation.md) - [Can I delete or rename a conversation?](https://docs.dust.tt/docs/can-i-delete-or-rename-a-conversation.md) - [Can I use the Dust agents in different languages?](https://docs.dust.tt/docs/can-i-use-the-dust-agents-in-different-languages.md) - [How can I find the ID of an agent?](https://docs.dust.tt/docs/how-can-i-find-the-id-of-an-agent.md): When using the API, you might need to use Agents' IDs. This is how to find it. - [When asking a question about data within Slack, the link to the thread isn’t always the right one](https://docs.dust.tt/docs/when-asking-a-question-about-data-within-slack-the-link-to-the-thread-isnt-always-the-right-one.md) - [I haven’t received a login, or I am having trouble logging in](https://docs.dust.tt/docs/i-havent-received-a-login-or-i-am-having-trouble-logging-in.md) - [I try to create an agent using the Table Query tool, but it doesn't work](https://docs.dust.tt/docs/i-try-to-create-an-agent-using-the-table-query-tool-but-it-doesnt-work.md) - [The agent is producing links that don’t work or is falsely claiming something untrue. What’s going on?](https://docs.dust.tt/docs/the-agent-is-producing-links-that-dont-work-and-falsely-claiming-something-untrue-whats-going-on.md) - [Why doesn't the agent remember what I said earlier in a conversation?](https://docs.dust.tt/docs/why-doesnt-the-agent-remember-what-i-said-earlier-in-a-conversation.md) - [Why isn't my recently updated document showing in agent responses?](https://docs.dust.tt/docs/why-isnt-my-recently-updated-document-showing-in-agent-responses.md) - [Can Dust remember and incorporate my feedback in the future?](https://docs.dust.tt/docs/can-dust-remember-and-incorporate-my-feedback-in-the-future.md) - [Is Dust down?](https://docs.dust.tt/docs/is-dust-down.md) - [Why is Dust slow or my agent taking too long to respond?](https://docs.dust.tt/docs/why-is-dust-slow-or-my-agent-taking-too-long-to-respond.md) - [File size limits](https://docs.dust.tt/docs/file-size-limits.md) - [How to Change Your Email Address in Dust](https://docs.dust.tt/docs/how-to-change-your-email-address-in-dust.md): Need to update your email address in Dust? The process is straightforward, but it requires a few specific steps to ensure a smooth transition. Here's how to do it: - [Create your first agent](https://docs.dust.tt/docs/quickstart-agent.md): Learn how to set-up your first AI powered agent in Dust - [How to write effective instructions](https://docs.dust.tt/docs/prompting-101-how-to-talk-to-your-agents.md) - [Understanding LLMs Context Windows](https://docs.dust.tt/docs/understanding-llms-context-windows.md) - [Understanding LLM Limitations: Counting and Parsing Structured Data](https://docs.dust.tt/docs/understanding-llm-limitations-counting-and-parsing-structured-data.md) - [Understanding Retrieval Augmented Generation](https://docs.dust.tt/docs/understanding-retrieval-augmented-generation-rag-and-the-search-method-in-dust.md): As you explore Dust's capabilities, you'll see you can create various types of AI agents, each designed to help you access and understand your data in different ways. - [Templates](https://docs.dust.tt/docs/templates.md) - [Knowledge](https://docs.dust.tt/docs/knowledge.md) - [Search data sources](https://docs.dust.tt/docs/search-your-data.md) - [Table queries](https://docs.dust.tt/docs/table-queries.md) - [Extract data](https://docs.dust.tt/docs/extract-data.md): Extract data from unstructured sources in a structured manner and feed it to LLMs - [Include data](https://docs.dust.tt/docs/include-data.md) - [Tools](https://docs.dust.tt/docs/tools.md) - [Airtable](https://docs.dust.tt/docs/airtable.md): Airtable's MCP server lets your Dust assistants read and write records, explore base schemas, and interact with your Airtable data directly from conversations. - [Agent Memory](https://docs.dust.tt/docs/agent-memory.md) - [Asana](https://docs.dust.tt/docs/asana.md) - [Ashby](https://docs.dust.tt/docs/ashby-mcp.md): Tools to search candidates, manage applications, create notes and referrals, and query jobs and reports in your Ashby ATS workspace. - [Attio](https://docs.dust.tt/docs/attio-mcp.md): The Attio MCP is a hosted Model Context Protocol server by Attio that lets agents search, create, and update CRM data in your Attio workspace. - [canva-mcp](https://docs.dust.tt/docs/canva-mcp.md) - [Confluence](https://docs.dust.tt/docs/confluence-tool.md) - [Databricks](https://docs.dust.tt/docs/databricks.md) - [File Generation](https://docs.dust.tt/docs/file-generation.md): Generate and convert files in various formats with your Dust agents - [Fathom](https://docs.dust.tt/docs/fathom-mcp.md): Tools to list meetings and retrieve full transcripts from your Fathom workspace via Dust's built-in Fathom MCP server. - [Gong](https://docs.dust.tt/docs/gong-mcp.md): Tools to list calls, retrieve call details, and fetch transcripts from Gong — enabling sales and go-to-market workflows directly from Dust. - [Freshservice](https://docs.dust.tt/docs/freshservice.md): The Freshservice tool provides the ability to manage tickets, submit service requests, access knowledge base articles, and handle approvals. - [Front](https://docs.dust.tt/docs/front-mcp.md): Tools to search conversations, read messages and contacts, manage tags and assignments, and send replies or comments in Front. - [GitHub](https://docs.dust.tt/docs/github.md): Tools to manage issues and pull requests - [Gmail](https://docs.dust.tt/docs/gmail.md): Connect Gmail to Dust agents to read messages, create drafts, and send emails using user credentials. - [Google Calendar](https://docs.dust.tt/docs/google-calendar.md) - [Google Drive](https://docs.dust.tt/docs/google-drive.md): Search, read, create, clone, edit and comment on files in Google Drive (Docs, Sheets, Presentations). - [[Deprecated] Google Sheets](https://docs.dust.tt/docs/google-sheets.md) - [HubSpot](https://docs.dust.tt/docs/hubspot.md): Tools to manage contacts, leads, companies and other entities from the HubSpot CRM - [Image Generation](https://docs.dust.tt/docs/image-generation.md): Generate images from text prompts using AI - [Jira](https://docs.dust.tt/docs/jira.md): The Jira tool is a powerful integration that allows users to seamlessly manage Jira projects and issues directly from within Dust. This feature enables automated ticket management, project tracking, and workflow transitions without leaving the Dust environment. - [jit-tools](https://docs.dust.tt/docs/jit-tools.md) - [Microsoft Outlook (Mail, Calendar)](https://docs.dust.tt/docs/outlook-tool-setup.md): Tools to read and write Outlook emails and drafts - [Microsoft Sharepoint and OneDrive tools](https://docs.dust.tt/docs/microsoft-drive-tool-setup.md): Tool to search in your personal Sharepoint/OneDrive content - [Microsoft Teams](https://docs.dust.tt/docs/microsoft-teams-tool-setup.md): Tool to search in your personal Microsoft teams content - [Microsoft Excel](https://docs.dust.tt/docs/microsoft-excel-tool.md): Make your agents search and edit Excel files in your Sharepoint/OneDrive. - [Miro](https://docs.dust.tt/docs/miro-mcp.md): Miro MCP is a remote MCP server provided by Miro that allows your Dust agents to interact directly with your Miro boards. It enables agents to read board content, generate diagrams, and produce code from visual assets such as prototypes, PRDs, and diagrams. - [Monday.com](https://docs.dust.tt/docs/monday.md): The Monday.com tool is a powerful integration that allows agents to seamlessly interact with Monday.com boards, items, groups, and users. This enables automated CRM workflows, project management automation, and lead tracking directly from within Dust. - [NetSuite](https://docs.dust.tt/docs/netsuite.md): NetSuite's AI Connector Service MCP lets your Dust assistants query records, run searches, and interact with your NetSuite account directly from conversations. Each user authenticates with their own NetSuite account, so permissions are enforced per user. - [Notion](https://docs.dust.tt/docs/notion-mcp.md): Tools to read and write Notion content - [Power BI](https://docs.dust.tt/docs/power-bi.md): Power BI's Remote MCP Server lets your Dust assistants query semantic models, retrieve schemas, and execute DAX queries directly from conversations. Each user authenticates with their own Microsoft account, so Power BI permissions are enforced per user. - [Productboard](https://docs.dust.tt/docs/productboard.md): Tools to capture customer feedback, manage product work, and sync product data with Productboard - [Slack tools](https://docs.dust.tt/docs/slack-mcp.md): Tools to search and interact with Slack content - [UKG Ready](https://docs.dust.tt/docs/ukg-ready.md): Tools to enable PTO workflows with UKG Ready - [Val Town](https://docs.dust.tt/docs/val-town.md): Tools to interact with Val Town's platform to write and scale serverless JavaScript. - [Vanta](https://docs.dust.tt/docs/vanta.md): Read-only tools to review compliance posture powered by Vanta's security platform. - [Voice and sound generation](https://docs.dust.tt/docs/voice-and-sound-generation.md) - [Salesloft](https://docs.dust.tt/docs/salesloft-mcp.md): Tools to read cadence actions and related context for sales workflows in Salesloft. - [Semrush](https://docs.dust.tt/docs/semrush.md) - [Slab](https://docs.dust.tt/docs/slab-mcp.md): Tools to read posts, browse topics, and search content in your Slab workspace via the Slab GraphQL API. - [Snowflake](https://docs.dust.tt/docs/snowflake-tool.md) - [Statuspage](https://docs.dust.tt/docs/statuspage-mcp.md): Tools to create and update incidents and retrieve page and component data from Atlassian Statuspage. - [Run agent](https://docs.dust.tt/docs/run-agent.md): Enables agents to run other agents as tools - [Web Search & Browse](https://docs.dust.tt/docs/web-navigation.md): How to make your agents find answers on the Internet - [Zendesk](https://docs.dust.tt/docs/zendesk-tools.md): Tools to search and manage Zendesk support tickets - [Wake-ups](https://docs.dust.tt/docs/wake-ups.md): Let agents schedule work in the future - [Computer](https://docs.dust.tt/docs/computer.md): Use Computer to let agents work safely with files, calculations, code, network requests, and larger workflows. - [Skills](https://docs.dust.tt/docs/skills.md) - [Skill Examples](https://docs.dust.tt/docs/examples-of-skills.md) - [Triggers](https://docs.dust.tt/docs/triggers.md) - [Schedules](https://docs.dust.tt/docs/scheduling-your-agent-beta.md) - [Webhooks](https://docs.dust.tt/docs/webhooks.md) - [Filter webhooks payload](https://docs.dust.tt/docs/filter-webhooks-payload.md): Learn how to write custom payload-filters for your triggers. - [Rate Limiting](https://docs.dust.tt/docs/rate-limiting.md) - [Integrations / using Dust from anywhere](https://docs.dust.tt/docs/automations.md) - [Dust MCP Server](https://docs.dust.tt/docs/dust-mcp-server.md): Connect compatible MCP clients to Dust so they can search workspace knowledge, work with conversations, and access files or Pods through the Model Context Protocol. - [Dust in Slack](https://docs.dust.tt/docs/slack.md): You can talk to your agents directly within Slack channels, which will give them the full context of the conversation automatically - [[Beta] Slack Auto-Join](https://docs.dust.tt/docs/slack-auto-join-channel-to-synchronize.md) - [Slack workflows](https://docs.dust.tt/docs/dust-assistants-in-a-slack-workflow.md) - [Send and Forward Email to Agents](https://docs.dust.tt/docs/email-agents.md) - [Zapier](https://docs.dust.tt/docs/trigger-your-dust-agent-from-anywhere-using-zapier.md): In this article, we will guide you through how to use the Dust block in Zapier to automatically trigger your Dust Agent from any other application. - [Make.com](https://docs.dust.tt/docs/make-dust-integration.md): In this article, we will guide you through how to use the Dust block in Make.com to automatically trigger your Dust Agent from any other application. - [n8n](https://docs.dust.tt/docs/n8n.md): In this article, we will guide you through how to use the Dust node in n8n to automatically trigger your Dust Agents from any other application. - [Power Automate](https://docs.dust.tt/docs/power-automate.md): Talk to an agent or upload a file from your Power Automate workflows - [Meeting transcripts](https://docs.dust.tt/docs/meeting-transcripts.md): Process meeting transcripts with any of your agents - [Google Sheets Add-on](https://docs.dust.tt/docs/beta-google-spreadsheets.md): Use Dust agents directly within your Google Spreadsheets - [Dust in Zendesk](https://docs.dust.tt/docs/zendesk.md): Use our Zendesk application from the marketplace to enable access to Dust agents by your support team directly within Zendesk - [Browser Extension (Chrome, Firefox & Chromium-based browsers)](https://docs.dust.tt/docs/chrome-extension.md): The Dust Browser Extension enables seamless integration between your browser and Dust conversations, allowing your agents to access webpage content and screenshots directly where you're working. - [Raycast Extension](https://docs.dust.tt/docs/raycast.md): The Raycast Extension enables seamless integration between Raycast and Dust, allowing you to invoke Dust agents directly from Raycast. - [Dust in Teams](https://docs.dust.tt/docs/dust-in-teams.md): Integrate your Dust AI agents directly into Microsoft Teams channels and conversations. Agents will have the context of the conversation and can collaborate with your team members in real-time. - [Go Deep](https://docs.dust.tt/docs/go-deep.md) - [Frames](https://docs.dust.tt/docs/frames.md): Frames turns agent outputs into living, interactive content. - [White-labeled Frames](https://docs.dust.tt/docs/white-labeled-frames.md) - [@deep-dive Agent](https://docs.dust.tt/docs/beta-deep-dive-agent-for-comprehensive-work.md): Default agent to conduct comprehensive, in-depth analysis across all company data, databases, and web sources: thorough investigation that may take several minutes. - [Troubleshooting your agent](https://docs.dust.tt/docs/how-to-optimize-your-dust-agent.md): Optimizing your Dust agents can enhance efficiency and accuracy in your workspace. - [Structured output format](https://docs.dust.tt/docs/structured-output-format.md): Structured output lets you constrain an agent's response to follow a specific JSON schema, ensuring consistent and machine-readable output. - [Agent Builder Sidekick](https://docs.dust.tt/docs/agent-builder-sidekick.md) - [Steering: Conversations that keep up with you](https://docs.dust.tt/docs/steering-conversations-that-keep-up-with-you.md): See every step as the agent works. Send a message mid-task and it adjusts. - [Branch a Conversation](https://docs.dust.tt/docs/branching-conversations.md): Start a new conversation from an existing one, carrying forward the full context. - [Context Compaction](https://docs.dust.tt/docs/context-compaction.md): Taking control of the context you provide to agents. - [Self Improving Skills](https://docs.dust.tt/docs/self-improving-skills.md): Automatically improve your workspace skills - [Overview](https://docs.dust.tt/docs/what-are-data-sources.md) - [Connections](https://docs.dust.tt/docs/connections.md): Connecting Data to Dust is a crucial step of your journey. But you also need to make that data available to your users. - [Websites](https://docs.dust.tt/docs/website-connection.md): Browse websites contents on Dust and add them as a datasource - [Folders](https://docs.dust.tt/docs/dust-folders.md) - [Conversation Files](https://docs.dust.tt/docs/folders-copy.md) - [Read images](https://docs.dust.tt/docs/image-processing-vision.md): Let AI agents analyze images you send them in regard to your company's data - [[Zapier] Automatically add any datasource to Dust](https://docs.dust.tt/docs/how-to-automatically-add-data-sources-to-dust-folders-with-zapier.md) - [[Beta] Import Jira issues](https://docs.dust.tt/docs/import-jira.md): A script to import Jira Tickets - [[Beta] Import Salesforce Data](https://docs.dust.tt/docs/import-salesforce.md): A script to import Salesforce accounts into a Dust datasource - [[Beta] Import Hubspot Data](https://docs.dust.tt/docs/import-hubspot.md): A script to import Data from Hubspot - [[Beta] Import Guru Cards](https://docs.dust.tt/docs/import-guru.md): A script to import Guru Cards - [[Beta] Import Linear Issues](https://docs.dust.tt/docs/import-linear.md) - [[Beta] Import Dropbox Files](https://docs.dust.tt/docs/beta-import-dropbox-files.md): A script to upsert Dropbox files to Dust - [[Beta] Import Front Conversations](https://docs.dust.tt/docs/beta-import-front-conversations.md): A script to upsert Front conversations to Dust - [Quickstart](https://docs.dust.tt/docs/quickstart-admin.md): Manage everything about your workspace as a Dust Admin. - [Access Controls and Permissions](https://docs.dust.tt/docs/access-controls-and-permissions.md) - [Memberships & Roles](https://docs.dust.tt/docs/setting-up-your-workspace.md) - [Single Sign-On (SSO)](https://docs.dust.tt/docs/single-sign-on-sso.md): How to enable SSO - [SAML SSO](https://docs.dust.tt/docs/saml-sso.md) - [Users and groups provisioning](https://docs.dust.tt/docs/users-and-groups-provisioning.md) - [Spaces management](https://docs.dust.tt/docs/data.md): Managing data in Dust is crucial, here's how to make sure you set the right data at the right place. - [Agents management](https://docs.dust.tt/docs/managing-agents.md) - [Connections Management](https://docs.dust.tt/docs/managing-datasources.md) - [Google Drive](https://docs.dust.tt/docs/google-drive-connection.md): How to set-up the Google Drive connection on Dust - [Notion](https://docs.dust.tt/docs/notion-connection.md): How to set-up your Notion connection on Dust - [Confluence](https://docs.dust.tt/docs/confluence-connection.md): How to set-up your Confluence connection on Dust - [Intercom](https://docs.dust.tt/docs/intercom-connection.md): Set-up your Intercom Connection on Dust - [Github](https://docs.dust.tt/docs/github-connection.md): Set-up your Github connection on Dust - [Microsoft](https://docs.dust.tt/docs/microsoft-connection.md): How to set-up your Dust Microsoft connection - [Zendesk](https://docs.dust.tt/docs/zendesk-connection.md): Set-up your Zendesk Connection on Dust - [Snowflake](https://docs.dust.tt/docs/snowflake-connection.md): How to set-up your Dust Snowflake connection - [BigQuery](https://docs.dust.tt/docs/bigquery.md): How to set-up your Dust BigQuery connection - [Gong](https://docs.dust.tt/docs/gong-connection.md) - [Tools management](https://docs.dust.tt/docs/tools-management.md) - [Adding an MCP Server](https://docs.dust.tt/docs/remote-mcp-server.md): Extending Dust's toolset beyond the default list of tools is possible by adding extra MCP Servers. Multiple authentication modes are available to comply with a large variety of third-party services. - [Personal vs Shared Credentials for Tools & MCP Servers](https://docs.dust.tt/docs/personal-vs-workspace-credentials-for-tools-mcp-servers.md): This guide explains how to understand and configure authentication options for tools and MCP servers in your Dust workspace. - [Salesforce](https://docs.dust.tt/docs/salesforce.md) - [Salesforce - Notes on API limit and permissions](https://docs.dust.tt/docs/dust-salesforce-connection-admin-guide-for-beta-testers.md) - [Managing Microsoft tools](https://docs.dust.tt/docs/managing-microsoft-tools.md) - [Computer admin setup](https://docs.dust.tt/docs/computer-admin.md): Configure network access, user-approved domains, configuration variables, and HTTPS secrets for Computer. - [Workspace analytics](https://docs.dust.tt/docs/workspace-analytics.md): Track your team's Dust usage - [Audit Logs](https://docs.dust.tt/docs/audit-logs.md) - [Audit Logs — Events Reference](https://docs.dust.tt/docs/audit-logs-events-reference.md) - [Seat management](https://docs.dust.tt/docs/seat-management.md): Understand seat types and how to manage them in your Dust workspace. - [Credits](https://docs.dust.tt/docs/credits.md): Understand what credits are, how they're calculated, and when they're free. - [Credit management](https://docs.dust.tt/docs/credit-management.md): How credit consumption works across individual credits, workspace pools, programmatic usage, and how to track usage. - [Optimize credit consumption](https://docs.dust.tt/docs/optimize-credit-consumption.md): Understand what drives credit usage and how to keep your workspace efficient as it scales. - [Train your team on credit optimization](https://docs.dust.tt/docs/train-team-credit-optimization.md): How to build the habits, framing, and workflows that make AI usage efficient at scale. - [Subscriptions & Payments](https://docs.dust.tt/docs/subscriptions.md): All you need to know about Dust subscriptions and billing. - [Admin Troubleshooting](https://docs.dust.tt/docs/admin-troubleshooting.md) - [Slack Troubleshooting](https://docs.dust.tt/docs/slack-troubleshooting.md): Quick fixes for Slack integration issues. ## - [Client Side MCP Server (Preview)](https://docs.dust.tt/docs/client-side-mcp-server.md) - [Creating Google Calendar events from a Dust agent](https://docs.dust.tt/docs/creating-google-calendar-events-from-a-dust-assistant.md) - [Allowing an agent to send an email](https://docs.dust.tt/docs/allowing-an-assistant-to-send-an-email.md) - [Dev : pre-configuring a custom MCP server](https://docs.dust.tt/docs/dev-pre-configuring-a-custom-mcp-server.md) ## API Reference - [Developer platform](https://docs.dust.tt/reference/developer-platform-overview.md): An overview of the Dust Developer Platform along with its associated design principles as well as the API reference - [Javascript SDK](https://docs.dust.tt/reference/javascript-sdk.md) - [Datasources](https://docs.dust.tt/reference/data-sources.md): You'll learn how to create Datasources, upload documents and leverage them to build more context-aware apps. - [Chunks and documents](https://docs.dust.tt/reference/database-models.md): Chunks and documents concepts - [Rate limits](https://docs.dust.tt/reference/rate-limits.md): API calls are rate limited, here are our current rate limits - [OpenAPI & Postman](https://docs.dust.tt/reference/openapi.md): Our API is documented using the OpenAPI 3.0 standard - [Get agent configuration](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-agent-configurations-sid.md): Retrieve the agent configuration identified by {sId} in the workspace identified by {wId}. - [Update agent configuration](https://docs.dust.tt/reference/patch_api-v1-w-wid-assistant-agent-configurations-sid.md): Update the agent configuration identified by {sId} in the workspace identified by {wId}. - [Search agents by name](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-agent-configurations-search.md): Search for agent configurations by name in the workspace identified by {wId}. - [Export agent configuration as YAML](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-agent-configurations-sid-export-yaml.md): Download the agent configuration identified by {sId} as a YAML file. - [Import agent configuration](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-agent-configurations-import.md): Create a new agent configuration from a JSON body matching the agent config schema. - [Archive agent configuration](https://docs.dust.tt/reference/delete_api-v1-w-wid-assistant-agent-configurations-sid.md): Archive the agent configuration identified by {sId} in the workspace identified by {wId}. The agent is soft-archived and triggers/editor-group memberships associated with it are disabled. - [List agents](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-agent-configurations.md): Get the agent configurations for the workspace identified by {wId}. - [Export workspace analytics](https://docs.dust.tt/reference/get_api-v1-w-wid-analytics-export.md): Export analytics data for the workspace identified by {wId} in CSV or JSON format. - [Get workspace usage data](https://docs.dust.tt/reference/get_api-v1-w-wid-workspace-usage.md): Deprecated: this endpoint will be removed after 2026-07-22. Use GET /api/v1/w/{wId}/analytics/export instead. Get usage data for the workspace identified by {wId} in CSV or JSON format. - [Get an app run](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-apps-aid-runs-runid.md): Retrieve a run for an app in the space identified by {spaceId}. - [Create an app run](https://docs.dust.tt/reference/post_api-v1-w-wid-spaces-spaceid-apps-aid-runs.md): Create and execute a run for an app in the space specified by {spaceId}. - [List apps](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-apps.md): Get all apps in the space identified by {spaceId}. - [Events streaming](https://docs.dust.tt/reference/events.md): In use when streaming conversations through the API - [Cancel message generation in a conversation](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-cancel.md) - [Create a content fragment](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-content-fragments.md): Create a new content fragment in the workspace identified by {wId}. - [Get the events for a conversation](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid-events.md): Get the events for a conversation in the workspace identified by {wId}. - [Get a conversation](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid.md): Get a conversation in the workspace identified by {wId}. Supports optional pagination of message content via limit and lastValue query parameters. - [Edit an existing message in a conversation](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-messages-mid-edit.md) - [Get events for a message](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid-messages-mid-events.md): Get events for a message in the workspace identified by {wId}. - [Create a message](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-messages.md): Create a message in the workspace identified by {wId} in the conversation identified by {cId}. - [Validate an action in a conversation message](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-messages-mid-validate-action.md): Approves or rejects an action taken in a specific message in a conversation - [Create a new conversation](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations.md): Create a new conversation in the workspace identified by {wId}. - [Update a conversation](https://docs.dust.tt/reference/patch_api-v1-w-wid-assistant-conversations-cid.md): Update a conversation's title or mark it as read or unread in the workspace identified by {wId}. - [Answer a user question in a conversation message](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-messages-mid-answer-question.md): Submits an answer to a question asked by an agent in a specific message - [Download a conversation-scoped file by path](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid-files-rel.md): Download a file from a conversation's file system by its scoped path. The path must be conversation-scoped, i.e. start with `conversation/` (as surfaced by agent file system tools). The file content is streamed directly from the conversation mount. - [Get a data source view](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-source-views-dsvid.md) - [Update a data source view](https://docs.dust.tt/reference/patch_api-v1-w-wid-spaces-spaceid-data-source-views-dsvid.md) - [Delete a data source view](https://docs.dust.tt/reference/delete_api-v1-w-wid-spaces-spaceid-data-source-views-dsvid.md) - [Search the data source view](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-source-views-dsvid-search.md): Search the data source view identified by {dsvId} in the workspace identified by {wId}. - [List Data Source Views](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-source-views.md): Retrieves a list of data source views for the specified space - [Retrieve a document from a data source](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-documents-documentid.md): Retrieve a document from a data source identified by {dsId} in the workspace identified by {wId}. - [Upsert a document in a data source](https://docs.dust.tt/reference/post_api-v1-w-wid-spaces-spaceid-data-sources-dsid-documents-documentid.md): Upsert a document in a data source in the workspace identified by {wId}. - [Delete a document from a data source](https://docs.dust.tt/reference/delete_api-v1-w-wid-spaces-spaceid-data-sources-dsid-documents-documentid.md): Delete a document from a data source in the workspace identified by {wId}. - [Update the parents of a document](https://docs.dust.tt/reference/post_api-v1-w-wid-spaces-spaceid-data-sources-dsid-documents-documentid-parents.md): Update the parents of a document in the data source identified by {dsId} in the workspace identified by {wId}. - [Get documents](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-documents.md): Get documents in the data source identified by {dsId} in the workspace identified by {wId}. - [Search the data source](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-search.md): Search the data source identified by {dsId} in the workspace identified by {wId}. - [Get a table](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid.md): Get a table in the data source identified by {dsId} in the workspace identified by {wId}. - [Delete a table](https://docs.dust.tt/reference/delete_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid.md): Delete a table in the data source identified by {dsId} in the workspace identified by {wId}. - [Get a row](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid-rows-rid.md): Get a row in the table identified by {tId} in the data source identified by {dsId} in the workspace identified by {wId}. - [Create a file upload URL](https://docs.dust.tt/reference/post_api-v1-w-wid-files.md) - [Delete a row](https://docs.dust.tt/reference/delete_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid-rows-rid.md): Delete a row in the table identified by {tId} in the data source identified by {dsId} in the workspace identified by {wId}. - [List rows](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid-rows.md): List rows in the table identified by {tId} in the data source identified by {dsId} in the workspace identified by {wId}. - [Upsert rows](https://docs.dust.tt/reference/post_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables-tid-rows.md): Upsert rows in the table identified by {tId} in the data source identified by {dsId} in the workspace identified by {wId}. - [Get tables](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables.md): Get tables in the data source identified by {dsId} in the workspace identified by {wId}. - [Upsert a table](https://docs.dust.tt/reference/post_api-v1-w-wid-spaces-spaceid-data-sources-dsid-tables.md): Upsert a table in the data source identified by {dsId} in the workspace identified by {wId}. - [Get data sources](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources.md): Get data sources in the workspace identified by {wId}. - [Check the upsert queue status for a data source](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-data-sources-dsid-check-upsert-queue.md): Returns the number of running document upsert workflows for this data source. This endpoint is only accessible with system API keys (e.g., from connectors). - [Get feedbacks for a conversation](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid-feedbacks.md): Retrieves all feedback entries for a specific conversation. Requires authentication and read:conversation scope. - [Submit feedback for a specific message in a conversation](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-conversations-cid-messages-mid-feedbacks.md): Submit user feedback (thumbs up/down) for a specific message in a conversation. Requires authentication and update:conversation scope. - [Delete feedback for a specific message](https://docs.dust.tt/reference/delete_api-v1-w-wid-assistant-conversations-cid-messages-mid-feedbacks.md): Delete user feedback for a specific message in a conversation. Requires authentication and update:conversation scope. - [Update heartbeat for a client-side MCP server](https://docs.dust.tt/reference/post_api-v1-w-wid-mcp-heartbeat.md): [Documentation](https://docs.dust.tt/docs/client-side-mcp-server) Update the heartbeat for a previously registered client-side MCP server. This extends the TTL for the server registration. - [Register a client-side MCP server](https://docs.dust.tt/reference/post_api-v1-w-wid-mcp-register.md): [Documentation](https://docs.dust.tt/docs/client-side-mcp-server) Register a client-side MCP server to Dust. The registration is scoped to the current user and workspace. A serverId identifier is generated and returned in the response. - [Stream MCP tool requests for a workspace](https://docs.dust.tt/reference/get_api-v1-w-wid-mcp-requests.md): [Documentation](https://docs.dust.tt/docs/client-side-mcp-server) Server-Sent Events (SSE) endpoint that streams MCP tool requests for a workspace. This endpoint is used by client-side MCP servers to listen for tool requests in real-time. The connection will remain open and events will be sent as new tool requests are made. - [Submit MCP tool execution results](https://docs.dust.tt/reference/post_api-v1-w-wid-mcp-results.md): [Documentation](https://docs.dust.tt/docs/client-side-mcp-server) Endpoint for client-side MCP servers to submit the results of tool executions. This endpoint accepts the output from tools that were executed locally. - [Deregister a client-side MCP server](https://docs.dust.tt/reference/post_api-v1-w-wid-mcp-deregister.md): [Documentation](https://docs.dust.tt/docs/client-side-mcp-server) Remove a previously registered client-side MCP server registration. - [Get mention suggestions for a conversation](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-conversations-cid-mentions-suggestions.md): Get suggestions for mentions (agents and users) based on a query string, scoped to a specific conversation. - [Parse mentions in markdown text](https://docs.dust.tt/reference/post_api-v1-w-wid-assistant-mentions-parse.md): Parses pasted text containing @ mentions and converts them to the proper mention format. Matches @agentName or @userName patterns against available agents and users. - [Get mention suggestions](https://docs.dust.tt/reference/get_api-v1-w-wid-assistant-mentions-suggestions.md): Get suggestions for mentions (agents and users) based on a query string. - [Search for nodes in the workspace](https://docs.dust.tt/reference/post_api-v1-w-wid-search.md): Search for nodes in the workspace - [Search for nodes in the workspace (streaming)](https://docs.dust.tt/reference/get_api-v1-w-wid-search.md): Search for nodes in the workspace with SSE streaming - [Upload a tool file](https://docs.dust.tt/reference/post_api-v1-w-wid-search-tools-upload.md): Download and upload a file from a tool (MCP server) to Dust - [List available MCP server views.](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces-spaceid-mcp-server-views.md): Retrieves a list of enabled MCP server views (aka tools) for a specific space of the authenticated workspace. - [Receive external webhook to trigger flows](https://docs.dust.tt/reference/post_api-v1-w-wid-triggers-hooks-webhooksourceid.md): Skeleton endpoint that verifies workspace and webhook source and logs receipt. - [List skills](https://docs.dust.tt/reference/get_api-v1-w-wid-skills.md): Retrieves the custom skills in the workspace. Active skills are returned by default. - [Import skills from uploaded files](https://docs.dust.tt/reference/post_api-v1-w-wid-skills.md): Imports skills from uploaded files or ZIP archives into the workspace. - [List available spaces.](https://docs.dust.tt/reference/get_api-v1-w-wid-spaces.md): Retrieves a list of accessible spaces for the authenticated workspace. - [Get current user](https://docs.dust.tt/reference/get_api-user.md): Returns the authenticated user with their workspaces and subscriber hash. - [Update current user](https://docs.dust.tt/reference/patch_api-user.md): Update the authenticated user's profile (name, job type, favorite platforms, image). - [Initiate WorkOS login](https://docs.dust.tt/reference/get_api-workos-login.md): Redirects to WorkOS AuthKit for authentication. Supports PKCE flow for extensions. - [Exchange code or refresh token](https://docs.dust.tt/reference/post_api-workos-authenticate.md): Exchanges an authorization code or refresh token for access tokens via WorkOS. - [Revoke a session](https://docs.dust.tt/reference/post_api-workos-revoke-session.md): Revokes a WorkOS session by session ID. Used by the Chrome extension for logout. - [List agent configurations](https://docs.dust.tt/reference/get_api-w-wid-assistant-agent-configurations.md): Returns all agent configurations in the workspace. - [Create an agent configuration](https://docs.dust.tt/reference/post_api-w-wid-assistant-agent-configurations.md): Creates a new agent configuration in the workspace. - [Cancel message generation](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-cancel.md): Cancels the generation of messages in a conversation. - [Create a content fragment](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-content-fragment.md): Post a new content fragment to an existing conversation. - [Get conversation feedbacks](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-feedbacks.md): Retrieve all feedbacks for a conversation submitted by the authenticated user. - [Get a conversation](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid.md): Retrieve a specific conversation by its ID. - [Delete or leave a conversation](https://docs.dust.tt/reference/delete_api-w-wid-assistant-conversations-cid.md): Delete a conversation or leave it if it is shared. - [Update a conversation](https://docs.dust.tt/reference/patch_api-w-wid-assistant-conversations-cid.md): Update a conversation's title, mark it as read, move it to a different space, or control URL access mode. - [Get conversation participants](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-participants.md): Returns the participants of a specific conversation. - [Add a participant to a conversation](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-participants.md): Adds the authenticated user as a participant to a specific conversation. - [List conversations](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations.md): Retrieve a paginated list of conversations for the authenticated user in the workspace. - [Create a conversation](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations.md): Create a new conversation, optionally with an initial user message and content fragments. - [Compact a conversation](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-compactions.md): Trigger compaction of a conversation, summarizing older messages into a compaction message. Requires a model to use for summary generation. - [Cancel a wake-up](https://docs.dust.tt/reference/delete_api-w-wid-assistant-conversations-cid-wakeups-wuid.md): Cancel a scheduled wake-up. Only the wake-up owner or a workspace admin can cancel. - [List wake-ups for a conversation](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-wakeups.md): Retrieve all wake-ups scheduled in a conversation (any status). - [Edit a message](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-messages-mid-edit.md): Edit the content and mentions of an existing user message in a conversation. - [Submit message feedback](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-messages-mid-feedbacks.md): Create or update feedback (thumbs up/down) for a specific agent message. - [Delete message feedback](https://docs.dust.tt/reference/delete_api-w-wid-assistant-conversations-cid-messages-mid-feedbacks.md): Remove the authenticated user's feedback for a specific agent message. - [Get a message](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-messages-mid.md): Retrieve a specific message by its ID within a conversation. - [Delete a message](https://docs.dust.tt/reference/delete_api-w-wid-assistant-conversations-cid-messages-mid.md): Soft-delete a user or agent message from a conversation. - [Retry an agent message](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-messages-mid-retry.md): Retry generating an agent message response, optionally retrying only blocked actions. - [List messages in a conversation](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-messages.md): Retrieve a paginated list of messages for a specific conversation. - [Post a message to a conversation](https://docs.dust.tt/reference/post_api-w-wid-assistant-conversations-cid-messages.md): Post a new user message to an existing conversation, triggering agent responses. - [Get a single action](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-messages-mid-actions-aid.md): Retrieve a single action by its ID within an agent message, along with the message status. - [Stream conversation events](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-events.md): Stream real-time conversation events using Server-Sent Events (SSE). This endpoint is redirected to /api/sse/ for SSE traffic routing. - [Stream message events](https://docs.dust.tt/reference/get_api-w-wid-assistant-conversations-cid-messages-mid-events.md): Stream real-time events for a specific agent message using Server-Sent Events (SSE). Only available for agent messages. This endpoint is redirected to /api/sse/ for SSE traffic routing. - [Stream sandbox function invocation events](https://docs.dust.tt/reference/get_api-w-wid-sandbox-functions-functionid-invocations-invocationid-events.md): Stream real-time events for a sandbox function invocation using Server-Sent Events (SSE). This endpoint is redirected to /api/sse/ for SSE traffic routing. - [Get or download a file](https://docs.dust.tt/reference/get_api-w-wid-files-fileid.md): View or download a file. Use query parameters `version` (original, processed, public) and `action` (view, download). - [Upload file content](https://docs.dust.tt/reference/post_api-w-wid-files-fileid.md): Process and store the uploaded file content. - [Delete a file](https://docs.dust.tt/reference/delete_api-w-wid-files-fileid.md): Delete a file from the workspace. - [Create a file upload](https://docs.dust.tt/reference/post_api-w-wid-files.md): Creates a file record and returns a pre-signed upload URL. The file content should then be uploaded to the returned URL. - [Get mention suggestions](https://docs.dust.tt/reference/get_api-w-wid-assistant-mentions-suggestions.md): Returns mention suggestions for the workspace. - [Get a data source view](https://docs.dust.tt/reference/get_api-w-wid-spaces-spaceid-data-source-views-dsvid.md): Returns the details of a specific data source view. - [Update a data source view](https://docs.dust.tt/reference/patch_api-w-wid-spaces-spaceid-data-source-views-dsvid.md): Updates a specific data source view. - [Delete a data source view](https://docs.dust.tt/reference/delete_api-w-wid-spaces-spaceid-data-source-views-dsvid.md): Deletes a specific data source view. - [List data source views](https://docs.dust.tt/reference/get_api-w-wid-spaces-spaceid-data-source-views.md): Returns all data source views in a specific space. - [Create a data source view](https://docs.dust.tt/reference/post_api-w-wid-spaces-spaceid-data-source-views.md): Creates a new data source view in a specific space. - [Get a space](https://docs.dust.tt/reference/get_api-w-wid-spaces-spaceid.md): Returns the details of a specific space including categories, members, and permissions. - [Update a space](https://docs.dust.tt/reference/patch_api-w-wid-spaces-spaceid.md): Updates the properties of a specific space. - [Delete a space](https://docs.dust.tt/reference/delete_api-w-wid-spaces-spaceid.md): Deletes a specific space from the workspace. - [List spaces](https://docs.dust.tt/reference/get_api-w-wid-spaces.md): Returns all spaces in the workspace. - [Create a space](https://docs.dust.tt/reference/post_api-w-wid-spaces.md): Creates a new space in the workspace. - [Get project notification preference](https://docs.dust.tt/reference/get_api-w-wid-spaces-spaceid-project-notification-preferences.md): Returns the current user's notification preference for a project space. - [Set project notification preference](https://docs.dust.tt/reference/patch_api-w-wid-spaces-spaceid-project-notification-preferences.md): Sets the current user's notification preference for a project space. - [Get extension configuration](https://docs.dust.tt/reference/get_api-w-wid-extension-config.md): Returns the extension configuration for the workspace, including blacklisted domains. - [Get workspace feature flags](https://docs.dust.tt/reference/get_api-w-wid-feature-flags.md): Returns the list of enabled feature flags for the workspace. - [Resolve a conversation go template draft](https://docs.dust.tt/reference/get_api-w-wid-assistant-go-template.md): Fetches a Contentful conversation go template by slug and returns a composer-ready draft with optional pre-uploaded attachments. - [Dust CLI](https://docs.dust.tt/reference/cli.md): A command-line interface for interacting with Dust - [What is a Dust App?](https://docs.dust.tt/reference/introduction-to-dust-apps.md): An introduction to large language models, prompting and Large Language Model apps (Dust Apps) design, covering, with no prerequesites, the core concepts required to build applications on top of large language models. - [Dust Apps: Core Concepts](https://docs.dust.tt/reference/dust-apps-core-concepts.md): Defining what Dust have to offer and learning about the core concepts - [Core blocks](https://docs.dust.tt/reference/core-blocks.md): An overview of Dust Apps core blocks. You'll learn about their functionality and usage. ## Changelog - [Changelog Update](https://docs.dust.tt/changelog/changelog-update-4.md) - [Changelog Update](https://docs.dust.tt/changelog/changelog-update-3.md) - [Changelog Update](https://docs.dust.tt/changelog/changelog-update-2.md) - [Changelog Update](https://docs.dust.tt/changelog/changelog-update-1.md) - [Select a Custom Default Agent in Pods](https://docs.dust.tt/changelog/select-a-custom-default-agent-in-pods.md)