> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dust - Connect StackOne

> Use the StackOne tool to connect your work systems to Dust.

For anyone using StackOne in Dust once your workspace admin has added it. If it is missing, ask your admin to add it.

Recommended Set up with your agentPaste this into a Dust chat. Dust walks you through it, one step at a time.

Help me connect StackOne to Dust. Read the setup guide at [https://docs.stackone.com/ai-platforms/setup-guide.md](https://docs.stackone.com/ai-platforms/setup-guide.md) and guide me one step at a time.
Copy

Or follow the steps yourself

## Connect

**1. Add StackOne to a chat**

1. In Dust, click **New** to start a conversation.
2. In the message box, type `/` and then `StackOne`.
3. Select **StackOne**.

![Dust's message box with /stack typed and StackOne selected in the Tools list above it](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/dust/dust-slash-menu-stackone.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=fc3afb47e32aaa9d5944b4bb1117046c)

> [accordion] StackOne isn't there
>
> Ask your Dust workspace admin to add it. Send them this:
>
> ```text theme={null}
> Can you add StackOne to Dust for our workspace? It goes under Spaces > Tools.
> ```

**2. Connect StackOne**

1. Send this message:

   ```text theme={null}
   Which of my Linked Accounts can you reach through StackOne?
   ```

2. Dust asks you to connect StackOne. Click **Connect**.

![A Dust conversation where the agent replies with a StackOne card and a Connect button](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/dust/dust-connect-stackone.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=02d1decedd3206bb3f9d2319cc92c7b7)

If Dust answers right away instead, your admin set StackOne up with one shared login for everyone. There is no sign-in step for you.

**3. Sign in and authorize**

1. Sign in to StackOne. In a desktop app or code editor, this opens in your browser.
2. If StackOne asks for a project, pick yours and click **Continue to Accounts**.
3. Pick the work systems Dust can use (your Linked Accounts).
4. If you see **Load tools when needed**, leave it on.
5. Click **Authorize**.

![StackOne's Select accounts screen with two Linked Accounts ticked, Load tools when needed on, and the Authorize button](https://mintcdn.com/stackone-60/RgaE_4ZxFuvAQ6gS/images/ai-platforms/oauth-consent-select-accounts.png?fit=max\&auto=format\&n=RgaE_4ZxFuvAQ6gS\&q=85\&s=66ef4eb4d8bf6e5246e5f01ec959c187)

**4. Check it works**

Back in Dust, click **Retry**. Dust runs your message again and lists the work systems it can reach. If Dust asks for your OK before it uses StackOne, approve it.

If there's no **Retry** button, send the message again:

```text theme={null}
Which of my Linked Accounts can you reach through StackOne?
```

## Use StackOne in an agent

To add StackOne to an agent you can edit, open it in the Agent Builder, click **Add Tool**, select **StackOne**, and save the agent.

An agent that runs on a schedule or a trigger has nobody there to click **Connect**. Connect StackOne in a chat first, using the steps above.

> [accordion] If something goes wrong
>
> **Can't find StackOne.** Your Dust workspace admin adds it under **Spaces → Tools**. If they limited it to certain spaces, ask them to add you to one.
>
> **A system you need is missing.** Ask your StackOne admin, or see [Linking Accounts](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md).
>
> **It stopped working.** Open your user menu at the bottom left and select **Tools & Triggers**. Click **Disconnect** next to StackOne, then send a message that uses StackOne and click **Connect** again. Access lasts 90 days from when you clicked **Authorize**. When it runs out, scheduled agents can't reach StackOne either.
>
> **It can't do something.** It can do only what your own StackOne access allows. Ask your StackOne admin.

> [accordion] Add or change accounts
>
> Dust reaches only the Linked Accounts you approved when you connected. To add one you link later, or one someone shares with you afterwards:
>
> **1. Open Connected Apps**
>
> In the StackOne dashboard, go to [**Connected Apps**](https://app.stackone.com/connected_apps).
>
> **2. Edit the connection**
>
> 1. Open the **⋮** menu on the row for Dust and select **Edit tool access**.
> 2. Select the Linked Account.
> 3. Click **Save changes**.
>
> To review or revoke the connection, use the same **⋮** menu in **Connected Apps**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.