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

# Asana

## How it works

The Asana connector imports tasks and their associated comments from either specific projects or all projects within a workspace.

## Setting Up

**Authorization**

1. Create a Personal Access Token
   * Log in to your Asana account and visit [https://app.asana.com/0/my-apps](https://app.asana.com/0/my-apps)
   * Click "Create New Personal Access Token"
   * Give it a recognizable name (e.g., "ASSIST AI Integration") and generate the token
   * Copy the token — you'll need it when configuring ASSIST AI

## Indexing

1. **Open the Asana Connector**
   Go to the Admin Panel and select the Asana Connector.

2. **Provide configuration**
   Fill in the following fields:
   * **Asana API Token:** Paste the Personal Access Token you just created.
   * **Workspace ID:** Enter your Asana workspace ID. You can look this up at [https://app.asana.com/api/1.0/workspaces](https://app.asana.com/api/1.0/workspaces) — it's a numeric value that looks like `1234567890123456`.
   * **Project IDs (optional):** To limit indexing to specific projects, enter their IDs separated by commas. Leave this blank to index all projects in the workspace (e.g., `1234567890123456,2345678901234567`). To find a project's ID, open the project in Asana and check the URL — in a link like `https://app.asana.com/0/1208338159336610/1208338159510597`, the project ID is `1208338159336610`.
   * **Team ID (optional):** If you'd like to include team-visible tasks alongside public ones, enter a team ID here. Leave this blank if it's not needed.

3. **Start indexing**
   Click "Connect" to begin the indexing process.

**Note:** The connector will operate within the permissions of the user linked to the provided API token. Make sure that user has access to all the projects you intend to index in ASSIST AI.