> ## Documentation Index
> Fetch the complete documentation index at: https://danswer-docs-versions-opensearch-example.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Index tasks and comments from Asana projects

## How it works

The Asana connector pulls in tasks and their associated comments from specified projects or all projects in a workspace.

## Setting up

### Authorization

<Steps>
  <Step title="Create Personal Access Token">
    * Log in to your Asana account and go to [https://app.asana.com/0/my-apps](https://app.asana.com/0/my-apps)
    * Click "Create New Personal Access Token"
    * Give it a name (e.g., "Onyx Integration") and create the token
    * Copy the token — you'll need to provide this to Onyx
  </Step>
</Steps>

### Indexing

<Steps>
  <Step title="Open Asana connector">
    Navigate to the Admin Panel and select the **Asana** Connector
  </Step>

  <Step title="Provide configuration">
    * **Asana API Token**: Paste the Personal Access Token you created earlier
    * **Workspace ID**: Enter your Asana workspace ID. You can find this at [https://app.asana.com/api/1.0/workspaces](https://app.asana.com/api/1.0/workspaces). It's a number that looks like 1234567890123456.
    * **Project IDs** (optional): If you want to index specific projects, enter their IDs separated by commas. Leave this empty to index all projects in the workspace. Example: 1234567890123456,2345678901234567. You can find a project ID by clicking on a project in Asana. In the URL, it will look like [https://app.asana.com/0/1208338159336610/1208338159510597](https://app.asana.com/0/1208338159336610/1208338159510597), where "1208338159336610" is the project ID.
    * **Team ID** (optional): If you want to index team-visible tasks in addition to public tasks,
      enter a team ID. Leave this empty if you don't need this feature.
  </Step>

  <Step title="Start indexing">
    Click "Connect" to start the indexing process
  </Step>
</Steps>

Note: The connector will respect the permissions of the user associated with the provided API token.
Ensure that this user has access to all the projects you want to index.


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