> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/asana.md).

# Asana

Asana is a work management platform for organizing tasks, projects, and team collaboration.

* MCP connection

### Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector   | Authentication |
| ----------- | -------------- |
| Asana       | API Key        |
| Asana       | OAuth sign-in  |
| Asana (MCP) | MCP with OAuth |

#### Asana

Connect to Asana to manage your projects and tasks. Supports task creation, updates, and management.

**Set up in Asana**

1. Sign in to Asana and open the developer console at <https://app.asana.com/0/my-apps> (or **My Settings → Apps → Manage Developer Apps**).
2. Click **Create new token**, name it, accept the Asana API terms, and create the token.
3. Copy the personal access token immediately; you won't be able to view it again.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Asana**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                                              |
| ------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key       | Yes      | Get the API key from the Personal access tokens section of your Asana account. You can find your tokens here: <https://app.asana.com/0/my-apps>. [Provider instructions](https://app.asana.com/0/my-apps). |

**Provider documentation:** [Setup reference](https://developers.asana.com/docs/personal-access-token).

#### Asana

Connect to Asana using OAuth2 for automatic authentication. This method handles token management automatically and provides access to all Asana features based on your app's configured scopes.

**Set up in Asana**

1. Sign in to Asana in the window that opens.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Asana**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

**Provider documentation:** [Setup reference](https://developers.asana.com/docs/oauth).

#### Asana (MCP)

Connect to Asana's MCP server for AI-powered access to your tasks, projects, and Asana Work Graph. Uses Asana's native MCP authentication.

**Set up in Asana**

1. Sign in to Asana and authorize access to your tasks, projects, and Work Graph.

**Set up in StackAI**

1. Open **Settings → Connections**, add a connection, and select **Asana (MCP)**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field          | Required                 | What to enter                                                                                                                                                                                                         |
| ---------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Client Secret          | Optional / as applicable | The OAuth client secret (e.g., 1234567890). You may not need to set this, the OAuth flow will try to set it with Dynamic Client Registration, but some MCP Servers don't support it, so they require a Client Secret. |
| Custom Headers         | Optional / as applicable | Enter the custom headers issued for the account or service you are connecting.                                                                                                                                        |
| MCP Server URL         | Yes                      | The MCP server URL (e.g., <https://mcp.example.com>).                                                                                                                                                                 |
| Client ID              | Optional / as applicable | The OAuth client ID (e.g., 1234567890). You may not need to set this, the OAuth flow will try to set it with Dynamic Client Registration, but some MCP Servers don't support it, so they require a Client ID.         |
| Authorization Endpoint | Optional / as applicable | The OAuth endpoint URL (e.g., <https://mcp.example.com/oauth2/authorize>). You probably don't have to set this, the OAuth flow will try to discover it on its own.                                                    |
| Description            | Optional / as applicable | Optional description for this MCP server connection.                                                                                                                                                                  |

**Provider documentation:** [Setup reference](https://developers.asana.com/docs).

#### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Use an action

1. Add the required **Asana** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

### Actions

| Action                                  | Purpose                                                                                                          | Required inputs                          |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| Delete Allocation                       | Delete an allocation.                                                                                            | Allocation                               |
| Get Allocation                          | Returns the complete allocation record for a single allocation.                                                  | Allocation                               |
| Update Allocation                       | Update an allocation.                                                                                            | Allocation                               |
| Get Allocations                         | Returns a list of allocations filtered to a specific project, user or placeholder.                               | None listed                              |
| Create Allocation                       | Creates a new allocation.                                                                                        | Assignee, Project, Start Date, End Date  |
| Delete Attachment                       | Delete an attachment.                                                                                            | Attachment                               |
| Get Attachment                          | Get the full record for a single attachment.                                                                     | Attachment                               |
| List Attachments                        | Returns the compact records for all attachments on the object.                                                   | Parent Resource                          |
| Add Attachment                          | Attach a file (uploaded from a URL) or external link to a task, project, or project brief in Asana.              | Parent                                   |
| Get Audit Log Events                    | Retrieve the audit log events that have been captured in your domain.                                            | Workspace                                |
| Create Batch Request                    | Execute multiple API requests in one batch.                                                                      | Actions                                  |
| Get Custom Field Settings for Project   | List all custom field settings applied to a specific project.                                                    | Project                                  |
| List Portfolio Custom Fields            | Returns a list of all of the custom fields settings on a portfolio, in compact form.                             | Portfolio                                |
| Create Custom Field                     | Creates a new custom field in a workspace.                                                                       | Workspace, Resource Subtype              |
| Delete Custom Field                     | Delete a custom field.                                                                                           | Custom Field                             |
| Get Custom Field                        | Get the complete definition of a custom field's metadata.                                                        | Custom Field                             |
| Update Custom Field Definition          | Edit a custom field's definition (name, description, enum options, format).                                      | Custom Field                             |
| Get Custom Fields For Workspace         | Returns a list of the compact representation of all of the custom fields in a workspace.                         | Workspace                                |
| Add Enum Option                         | Creates an enum option and adds it to this custom field's list of enum options.                                  | Custom Field                             |
| Reorder Enum Option                     | Reorder an enum option in a custom field.                                                                        | Custom Field, Enum Option                |
| Update Enum Option                      | Update an enum option's name, color, or enabled status.                                                          | Enum Option                              |
| Get Custom Types                        | Returns a list of all of the custom types associated with a project.                                             | Project                                  |
| Get Events                              | Returns the full record for all events that have occurred since the sync token was created.                      | Resource                                 |
| Get Goal Relationship                   | Returns the complete goal relationship record for a single goal relationship.                                    | Goal Relationship                        |
| Update Goal Relationship                | Update a goal relationship.                                                                                      | Goal Relationship                        |
| Get Goal Relationships                  | Returns compact goal relationship records.                                                                       | Supported Goal                           |
| Add Supporting Relationship             | Add a supporting resource to a goal.                                                                             | Parent Goal, Supporting Resource         |
| Remove Supporting Relationship          | Remove a supporting resource from a goal.                                                                        | Parent Goal, Supporting Resource         |
| Delete Goal                             | Delete a goal.                                                                                                   | Goal                                     |
| Get Goal                                | Returns the complete goal record for a single goal.                                                              | Goal                                     |
| Update Goal                             | Update a goal.                                                                                                   | Goal                                     |
| Get Goals                               | Returns compact goal records.                                                                                    | None listed                              |
| Create Goal                             | Creates a new goal in a workspace or team.                                                                       | Workspace, Goal Name                     |
| Create Goal Metric                      | Creates and adds a goal metric to a specified goal.                                                              | Goal, Metric Type, Unit, Progress Source |
| Update Goal Metric                      | Update a goal metric value.                                                                                      | Goal, New Value                          |
| Add Followers                           | Adds followers to a goal.                                                                                        | Goal, Followers                          |
| Remove Followers                        | Removes followers from a goal.                                                                                   | Goal, Followers                          |
| Get Parent Goals For Goal               | Returns a compact representation of all of the parent goals of a goal.                                           | Goal                                     |
| Get Job                                 | Returns the full record for a job.                                                                               | Job                                      |
| Get Memberships                         | Returns compact goal, project, or portfolio membership records.                                                  | None listed                              |
| Create Membership                       | Creates a new membership in a goal, project, or portfolio.                                                       | Parent Resource, Member                  |
| Delete Membership                       | Permanently deletes a membership.                                                                                | Membership                               |
| Get Membership                          | Returns a project, goal, or portfolio membership record for the given membership gid.                            | Membership                               |
| Update Membership                       | Update a membership's access level.                                                                              | Membership                               |
| Create Organization Export              | Creates a request to export an Organization's full data in JSON format.                                          | Organization                             |
| Get Organization Export                 | Returns details of an organization export request, including the download URL when complete.                     | Organization Export                      |
| Get Portfolio Memberships               | Returns a list of portfolio memberships in compact representation.                                               | None listed                              |
| Get Portfolio Membership                | Returns the complete portfolio record for a single portfolio membership.                                         | Portfolio Membership                     |
| List Portfolio Members                  | Returns the compact portfolio membership records for the portfolio.                                              | Portfolio                                |
| Get Portfolios                          | Returns a list of the portfolios in compact representation that are owned by the current API user.               | Workspace                                |
| Create Portfolio                        | Creates a new portfolio in the given workspace.                                                                  | Workspace, Portfolio Name                |
| Delete Portfolio                        | Delete a portfolio.                                                                                              | Portfolio                                |
| Get Portfolio                           | Returns the complete portfolio record for a single portfolio.                                                    | Portfolio                                |
| Update Portfolio                        | Update a portfolio.                                                                                              | Portfolio                                |
| List Portfolio Items                    | Get a list of the items in compact form in a portfolio.                                                          | Portfolio                                |
| Add Item to Portfolio                   | Add an item to a portfolio.                                                                                      | Portfolio, Item                          |
| Remove Item from Portfolio              | Remove an item from a portfolio.                                                                                 | Portfolio, Item                          |
| Add Custom Field to Portfolio           | Add a custom field to a portfolio.                                                                               | Portfolio, Custom Field                  |
| Remove Custom Field from Portfolio      | Removes a custom field setting from a portfolio.                                                                 | Portfolio, Custom Field                  |
| Add Members For Portfolio               | Adds the specified list of users as members of the portfolio.                                                    | Portfolio, Members                       |
| Remove Members For Portfolio            | Removes the specified list of users from members of the portfolio.                                               | Portfolio, Members                       |
| Delete Project Brief                    | Permanently deletes a project brief.                                                                             | Project Brief                            |
| Get Project Brief                       | Get the full record for a project brief, including its HTML content.                                             | Project Brief                            |
| Update Project Brief                    | Update the title or content of a project brief.                                                                  | Project Brief                            |
| Create Project Brief                    | Creates a new project brief on a project.                                                                        | Project                                  |
| Get Project Membership                  | Returns the full record for a single project membership, including the member and their access level.            | Project Membership                       |
| Get Project Memberships for Project     | List all memberships for a specific project, optionally filtered by user.                                        | Project                                  |
| Delete Project Template                 | Permanently deletes a project template.                                                                          | Project Template                         |
| Get Project Template                    | Returns the complete project template record for a single project template.                                      | Project Template                         |
| Get Project Templates                   | List project templates for a workspace or team.                                                                  | None listed                              |
| Get Project Templates for Team          | List all project templates belonging to a specific team.                                                         | Team                                     |
| Instantiate Project                     | Create a project from a template.                                                                                | Project Template, Name                   |
| Get Projects                            | Returns the compact project records for some filtered set of projects.                                           | None listed                              |
| Create Project                          | Create a new project in a workspace or team.                                                                     | Workspace, Project Name                  |
| Delete Project                          | Delete a project.                                                                                                | Project                                  |
| Get Project                             | Returns the complete project record for a single project.                                                        | Project                                  |
| Update Project                          | Update a project.                                                                                                | Project                                  |
| Duplicate Project                       | Duplicate a project.                                                                                             | Project, New Project Name                |
| Get Projects For Task                   | Returns a compact representation of all of the projects the task is in.                                          | Task                                     |
| Get Projects For Team                   | Returns the compact project records for all projects in the team.                                                | Team                                     |
| Create Project For Team                 | Creates a project shared with the given team.                                                                    | Team, Project Name                       |
| Get Projects For Workspace              | Returns the compact project records for all projects in the workspace.                                           | Workspace                                |
| Add Custom Field Setting for Project    | Add a custom field to a project.                                                                                 | Project, Custom Field                    |
| Remove Custom Field Setting for Project | Remove a custom field from a project.                                                                            | Project, Custom Field                    |
| Get Project Task Counts                 | Get task count statistics for a project.                                                                         | Project                                  |
| Add Members for Project                 | Add members to an Asana project.                                                                                 | Project, Members                         |
| Remove Members for Project              | Remove members from an Asana project.                                                                            | Project, Members                         |
| Add Followers for Project               | Add followers to an Asana project.                                                                               | Project, Followers                       |
| Remove Followers for Project            | Remove followers from an Asana project.                                                                          | Project, Followers                       |
| Save Project as Template                | Save a project as a template.                                                                                    | Project, Template Name, Public           |
| Trigger Rule                            | Trigger a rule via an incoming web request.                                                                      | Rule Trigger GID, Resource, Action Data  |
| Delete Section                          | Delete an empty section.                                                                                         | Section                                  |
| Get Section                             | Returns the complete record for a single section.                                                                | Section                                  |
| Update Section                          | Update a section.                                                                                                | Section                                  |
| List Project Sections                   | List all sections in a project.                                                                                  | Project                                  |
| Create Section For Project              | Creates a new section in a project.                                                                              | Project, Section Name                    |
| Add Task For Section                    | Move an existing task into a section, with optional positioning.                                                 | Section, Task                            |
| Reorder Section                         | Reorder sections in a project.                                                                                   | Project, Section                         |
| Delete Status Update                    | Permanently deletes a status update from a project, portfolio, or goal.                                          | Status Update                            |
| Get Status Update                       | Returns the full record for a status update on a project, goal, or portfolio.                                    | Status Update                            |
| List Status Updates                     | Returns the compact status update records for all updates on an object.                                          | Parent Resource                          |
| Create Status Update                    | Creates a new status update on a project, portfolio, or goal.                                                    | Parent Resource                          |
| Delete Story                            | Delete a story (comment or activity).                                                                            | Story                                    |
| Get Story                               | Returns the full record for a single story (comment or activity entry).                                          | Story                                    |
| Update Story                            | Update a story (comment or activity record).                                                                     | Story                                    |
| List Task Comments                      | List all comments and activity on a task.                                                                        | Task                                     |
| Add Comment to Task                     | Add a comment to a task.                                                                                         | Task                                     |
| Delete Tag                              | Delete a tag.                                                                                                    | Tag                                      |
| Get Tag                                 | Returns the complete tag record for a single tag.                                                                | Tag                                      |
| Update Tag                              | Update a tag.                                                                                                    | Tag                                      |
| Get Tags For Task                       | Get a compact representation of all of the tags the task has.                                                    | Task                                     |
| Get Tags For Workspace                  | Returns the compact tag records for some filtered set of tags.                                                   | Workspace                                |
| Create Tag For Workspace                | Creates a new tag in a workspace.                                                                                | Workspace                                |
| Get Task Templates                      | Returns the compact task template records for a project.                                                         | Project                                  |
| Delete Task Template                    | Delete a task template.                                                                                          | Task Template                            |
| Get Task Template                       | Returns the complete task template record for a single task template.                                            | Task Template                            |
| Create Task from Template               | Create a new task from a task template.                                                                          | Task Template                            |
| Get Tasks                               | Returns the compact task records for some filtered set of tasks.                                                 | None listed                              |
| Create Task                             | Create a new task in a project.                                                                                  | Workspace, Project, Task Name            |
| Delete Task                             | Deletes a task.                                                                                                  | Task                                     |
| Get Task                                | Get the full details of a task.                                                                                  | Task                                     |
| Update Task                             | Update fields on an existing Asana task and return the updated record.                                           | Task                                     |
| Duplicate Task                          | Duplicate a task.                                                                                                | Task                                     |
| List Tasks in Project                   | List all tasks in a project.                                                                                     | Project                                  |
| Get Tasks For Section                   | List all tasks in a section (board view only).                                                                   | Section                                  |
| Get Tasks For Tag                       | Returns the compact task records for all tasks with the given tag.                                               | Tag                                      |
| List My Tasks                           | List tasks in a user's "My Tasks" list.                                                                          | User Task List                           |
| Get Subtasks For Task                   | Returns a compact representation of all of the subtasks of a task.                                               | Task                                     |
| Create Subtask For Task                 | Create a subtask under a parent task.                                                                            | Parent Task, Subtask Name                |
| Set Parent For Task                     | Set or remove the parent of a task.                                                                              | Task, Parent                             |
| Get Dependencies For Task               | Returns the compact representations of all of the dependencies of a task.                                        | Task                                     |
| Add Dependencies For Task               | Marks a set of tasks as dependencies of this task, if they are not already dependencies.                         | Task                                     |
| Remove Dependencies For Task            | Unlinks a set of dependencies from this task.                                                                    | Task                                     |
| Get Dependents For Task                 | Returns the compact representations of all of the dependents of a task.                                          | Task                                     |
| Add Dependents For Task                 | Marks a set of tasks as dependents of this task, if they are not already dependents.                             | Task                                     |
| Remove Dependents For Task              | Unlinks a set of dependents from this task.                                                                      | Task                                     |
| Add Project For Task                    | Adds the task to the specified project, in the optional location specified.                                      | Project, Task                            |
| Remove Project For Task                 | Removes the task from the specified project.                                                                     | Project, Task                            |
| Add Tag For Task                        | Adds a tag to a task.                                                                                            | Task, Tag                                |
| Remove Tag For Task                     | Removes a tag from a task.                                                                                       | Task, Tag                                |
| Add Followers For Task                  | Adds followers to a task.                                                                                        | Task, Followers                          |
| Remove Follower For Task                | Removes each of the specified followers from the task if they are following.                                     | Task, Followers                          |
| Get Task by Custom ID                   | Get a task by its custom ID shortcode.                                                                           | Workspace, Custom ID                     |
| Search Tasks                            | Search tasks in a workspace with filters.                                                                        | Workspace                                |
| Get Team Membership                     | Returns the complete team membership record for a single team membership.                                        | Team Membership                          |
| Get Team Memberships                    | Returns compact team membership records.                                                                         | None listed                              |
| List Team Members                       | Returns the compact team memberships for the team.                                                               | Team                                     |
| List User's Team Memberships            | Returns the compact team membership records for the user.                                                        | Workspace, User                          |
| Create Team                             | Creates a team within the current workspace.                                                                     | Name, Organization                       |
| Get Team                                | Returns the full record for a single team.                                                                       | Team                                     |
| Update Team                             | Update a team's name, description, or visibility settings.                                                       | Team                                     |
| Get Teams For Workspace                 | Returns the compact records for all teams in the workspace visible to the authorized user.                       | Workspace                                |
| Get Teams For User                      | Returns the compact records for all teams to which the given user is assigned.                                   | Workspace / Organization, User           |
| Add User For Team                       | Add a user to a team.                                                                                            | Team                                     |
| Remove User For Team                    | Remove a user from a team.                                                                                       | Team                                     |
| Get Time Period                         | Returns the full record for a single time period.                                                                | Time Period                              |
| Get Time Periods                        | Returns compact time period records.                                                                             | Workspace                                |
| Get Time Tracking Entries For Task      | Returns a paginated list of all time tracking entries for a task.                                                | Task                                     |
| Create Time Tracking Entry              | Log time against an Asana task by creating a time tracking entry.                                                | Task, Duration (minutes)                 |
| Delete Time Tracking Entry              | Permanently deletes a time tracking entry.                                                                       | Time Tracking Entry                      |
| Get Time Tracking Entry                 | Returns the complete time tracking entry record for a single time tracking entry.                                | Time Tracking Entry                      |
| Update Time Tracking Entry              | Update a time tracking entry's duration or date.                                                                 | Time Tracking Entry                      |
| Search (Typeahead)                      | Retrieves objects in the workspace based via an auto-completion/typeahead search algorithm.                      | Workspace, Resource Type                 |
| Get User Task List                      | Returns the full record for a user task list.                                                                    | User Task List                           |
| Get User Task List For User             | Returns the full record for a user's task list.                                                                  | Workspace, User                          |
| Get Users                               | Returns the user records for all users in all workspaces and organizations accessible to the authenticated user. | None listed                              |
| Get User                                | Returns the full user record for the single user with the provided ID.                                           | User                                     |
| Get Favorites For User                  | Returns all of a user's favorites in the given workspace of the given type.                                      | Workspace, User, Resource Type           |
| Get Users For Team                      | Returns the compact records for all users that are members of the team.                                          | Team                                     |
| Get Users For Workspace                 | Returns the compact records for all users in the specified workspace or organization.                            | Workspace                                |
| Get Webhooks                            | Get all webhooks registered by your app for the authenticated user in a workspace.                               | Workspace                                |
| Create Webhook                          | Create a webhook to receive real-time event notifications when Asana resources change.                           | Resource GID, Target URL                 |
| Delete Webhook                          | Permanently deletes a webhook.                                                                                   | Webhook                                  |
| Get Webhook                             | Returns the full record for a webhook, including its resource, target URL, and active status.                    | Webhook                                  |
| Update Webhook                          | Update a webhook's event filters.                                                                                | Webhook                                  |
| Get Workspace Membership                | Returns the complete workspace membership record for a single workspace membership.                              | Workspace Membership                     |
| Get Workspace Memberships For User      | Returns the compact workspace membership records for the user.                                                   | User                                     |
| List Workspace Members                  | Returns the compact workspace membership records for the workspace.                                              | Workspace                                |
| Get Workspaces                          | List the workspaces and organizations the authenticated user can access.                                         | None listed                              |
| Get Workspace                           | Returns the full workspace record for a single workspace.                                                        | Workspace                                |
| Update Workspace                        | Update a workspace's name and return the updated workspace record.                                               | Workspace                                |
| Add User For Workspace                  | Add a user to a workspace or organization.                                                                       | Workspace                                |
| Remove User For Workspace               | Remove a user from a workspace or organization.                                                                  | Workspace                                |
| Get Workspace Events                    | Returns the full record for all events that have occurred since the sync token was created.                      | Workspace                                |
| Search Projects                         | Search for projects in a workspace.                                                                              | Workspace                                |
| List Reactions                          | Returns reactions for a selected emoji on an Asana status update or story.                                       | Target, Emoji Base                       |
| Duplicate Portfolio                     | Duplicate a portfolio.                                                                                           | Portfolio, New Portfolio Name            |
| Update User                             | Update a user's properties such as name and return the updated record.                                           | User                                     |
| Update User For Workspace               | Update a user in a workspace.                                                                                    | Workspace, User                          |
| Get User For Workspace                  | Returns the user record for a single user in a workspace.                                                        | Workspace, User                          |
| Get Custom Type                         | Returns the complete record for a single custom type.                                                            | Custom Type                              |
| List Team Custom Fields                 | Returns a list of all the custom field settings on a team, in compact representations.                           | Team                                     |

### Triggers

| Trigger                           | Event                                                                                                                                                   |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| On Task Change                    | Runs your workflow whenever an Asana task is updated (any field changes).                                                                               |
| On Task Added                     | Runs your workflow whenever a task is added to the scoped Asana project.                                                                                |
| On Task Completed                 | Runs your workflow whenever an Asana task is marked complete.                                                                                           |
| On Task Assigned                  | Runs your workflow whenever an Asana task's assignee changes.                                                                                           |
| On Task Due Date Changed          | Runs your workflow whenever an Asana task's due date changes.                                                                                           |
| On Task Moved                     | Runs your workflow whenever an Asana task is moved between sections in a project.                                                                       |
| On Task Deleted                   | Runs your workflow whenever an Asana task is deleted.                                                                                                   |
| On Subtask Added                  | Runs your workflow whenever a subtask is added to an Asana task.                                                                                        |
| On Comment Added                  | Runs your workflow whenever a comment is added to an Asana task.                                                                                        |
| On Section Added                  | Runs your workflow whenever a section is created in an Asana project.                                                                                   |
| On Project Added                  | Runs your workflow whenever a new project is created in the workspace.                                                                                  |
| On Project Status Update          | Runs your workflow whenever a status update is posted to an Asana project.                                                                              |
| On Project Added to Portfolio     | Runs your workflow whenever a project is added to an Asana portfolio.                                                                                   |
| On Project Removed from Portfolio | Runs your workflow whenever a project is removed from an Asana portfolio.                                                                               |
| On Portfolio Project Changed      | Runs your workflow whenever a project in an Asana portfolio changes. Asana cannot narrow this to specific fields, so every project change is delivered. |
| On Portfolio Item Status Changed  | Runs your workflow whenever an item in an Asana portfolio — a project or a nested portfolio — posts a new status update.                                |

### Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/asana.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
