> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onyx.app/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.