> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Asana

Read Asana workspaces, projects and tasks, create and complete tasks, add comments, and start a workflow when a task or project changes.

## What it can do

- Read: **Get the signed-in user**, **List workspaces**, **Get a workspace**, **List projects in a workspace**, **Get a project**, **List sections in a project**, **Get a section**, **List tasks in a project**, **Search tasks in a workspace**, **Get a task**, **List subtasks**, **List comments and activity on a task**, **Get a comment or story** and **List people in a workspace**.
- Change: **Create a task**, **Update a task**, **Mark a task complete**, **Move a task into a section**, **Create a section** and **Add a comment**.

Comments are stories. **Search tasks in a workspace** works on a premium workspace. A person is chosen by id, not by email address. One list is one page. Rich text is not included. Asana's published permission list does not name listing, getting or creating a section, so those three may be refused. This app does not ask for full access.

## What can start a workflow

- **Task added**, **Task changed**, **Task deleted**, **Task removed from a parent**, **Comment added**, **Section added**, **Section changed** and **Project changed**.
- Watch a project or a task. A workspace watch does not receive task, comment or section changes.
- An empty notice must be answered, or Asana removes the watch. A secret in the address is not accepted. Studio checks the signature on the raw notice.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Asana.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Asana asks for on its own sign-in page.** Choose **Continue to Asana** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Asana opens soon on this server.**, this server cannot sign Asana in yet. If you do not see **Add**, ask an admin to add Asana.

## What it asks for

- Read workspaces, projects, tasks, comments and people (`workspaces:read`, `projects:read`, `tasks:read`, `stories:read`, `users:read`).
- Create and update tasks (`tasks:write`). A write permission does not include the matching read.
- Read and write comments (`stories:write` as well as `stories:read`).
- Read, create and delete watches (`webhooks:read`, `webhooks:write`, `webhooks:delete`).

## Related

- [Jira](https://falcon.com/docs/app-jira)
- [Linear](https://falcon.com/docs/app-linear)
- [Connections](https://falcon.com/docs/connections)