# Asana

Tool to help teams organize, track, and manage their work.

- **Category:** project management
- **Auth:** OAUTH2
- **Tools:** 154
- **Triggers:** 1
- **Slug:** `ASANA`
- **Version:** 20260217_00

## Frequently Asked Questions

### How do I set up custom OAuth credentials for Asana?

For a step-by-step guide on creating and configuring your own Asana OAuth credentials with Devcaster, see [How to create OAuth credentials for Asana](https://devcaster.dev/auth/asana).

## Tools

### Add Followers to Project

**Slug:** `ASANA_ADD_FOLLOWERS_TO_PROJECT`

Tool to add followers to a project in Asana. Use this tool when you need to add one or more users as followers to a specific project. Followers will receive notifications when tasks are added to the project.

### Add Followers to Task

**Slug:** `ASANA_ADD_FOLLOWERS_TO_TASK`

Tool to add followers to a task in Asana. Use this tool when you need to add one or more users as followers to a specific task. This will notify them of updates to the task.

### Add item to portfolio

**Slug:** `ASANA_ADD_ITEM_TO_PORTFOLIO`

Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint. Use when a workflow needs to attach a newly created project to a portfolio without using ASANA_SUBMIT_PARALLEL_REQUESTS.

### Add Members to Project

**Slug:** `ASANA_ADD_MEMBERS_FOR_PROJECT`

Tool to add users to a project in Asana. Use this tool when you need to add one or more users as members to a specific project. Members can view and contribute to the project.

### Add Project to Task

**Slug:** `ASANA_ADD_PROJECT_FOR_TASK`

Tool to add a project to a task in Asana. Use when you need to associate a task with a project. Optionally position the task within the project using insert_before, insert_after, or section parameters.

### Add Supporting Relationship to Goal

**Slug:** `ASANA_ADD_SUPPORTING_RELATIONSHIP`

Tool to add a supporting goal relationship to a goal. Use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in Asana.

### Add Tag to Task

**Slug:** `ASANA_ADD_TAG_TO_TASK`

Tool to add an existing tag to a task in Asana. Use when you need to add a tag for prioritization, routing, or automation workflows. Tags cannot be added via Update Task, so this dedicated endpoint is required.

### Add Task Dependencies

**Slug:** `ASANA_ADD_TASK_DEPENDENCIES`

Tool to add dependency relationships to an Asana task. Use when you need to mark one or more tasks as prerequisites (dependencies) for another task, ensuring the dependency tasks must be completed first.

### Add task to section

**Slug:** `ASANA_ADD_TASK_TO_SECTION`

Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.

### Add User for Team

**Slug:** `ASANA_ADD_USER_FOR_TEAM`

Tool to add a user to a team in Asana. Use this when you need to add a user to a specific team by providing their user GID, email, or "me" for the current user.

### Add User for Workspace

**Slug:** `ASANA_ADD_USER_FOR_WORKSPACE`

Tool to add a user to a workspace or organization in Asana. Use this when you need to add a user to a specific workspace by providing their user GID, email, or "me" for the current user.

### Approve Access Request

**Slug:** `ASANA_APPROVE_ACCESS_REQUEST`

Tool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.

### Create Access Request

**Slug:** `ASANA_CREATE_ACCESS_REQUEST`

Tool to create an access request in Asana. Use when you need to request access to a project or portfolio that you don't currently have access to.

### Create Allocation

**Slug:** `ASANA_CREATE_ALLOCATION`

Creates a new allocation. Use when you need to schedule or assign a specific amount of a user's time per week to a task or project within a defined period.

### Create a project

**Slug:** `ASANA_CREATE_A_PROJECT`

Creates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.

### Create a tag in a workspace

**Slug:** `ASANA_CREATE_A_TAG_IN_A_WORKSPACE`

Creates a new tag, with properties like name and color defined in the request body, within a specific Asana workspace (using `workspace_gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.

### Create task in asana with specific details

**Slug:** `ASANA_CREATE_A_TASK`

Creates a new Asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.

### Create Attachment for Object

**Slug:** `ASANA_CREATE_ATTACHMENT_FOR_OBJECT`

Tool to upload an attachment or link an external resource to a task, project, or project_brief in Asana. Use when you need to attach a file or external URL to any Asana object.

### Create Attachment for Task

**Slug:** `ASANA_CREATE_ATTACHMENT_FOR_TASK`

Tool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.

### Create Custom Field

**Slug:** `ASANA_CREATE_CUSTOM_FIELD`

Tool to create a new custom field in a workspace. Use when you need to define a new field for tracking specific information within Asana tasks.

### Create Enum Option for Custom Field

**Slug:** `ASANA_CREATE_ENUM_OPTION_FOR_CUSTOM_FIELD`

Tool to create a new enum option for a custom field in Asana. Use this when you need to add a new selectable option to an existing custom field.

### Create Membership

**Slug:** `ASANA_CREATE_MEMBERSHIP`

Tool to create a membership by adding a user or team to a project, goal, or portfolio. Use when you need to grant access to an Asana resource.

### Create Project Brief

**Slug:** `ASANA_CREATE_PROJECT_BRIEF`

Tool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.

### Create project for team

**Slug:** `ASANA_CREATE_PROJECT_FOR_TEAM`

Tool to create a project in a team. Use when you need to create a new project within a specific Asana team.

### Create project for workspace

**Slug:** `ASANA_CREATE_PROJECT_FOR_WORKSPACE`

Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace. Note: The team field is required when creating projects in workspaces.

### Create Project Status Update

**Slug:** `ASANA_CREATE_PROJECT_STATUS_UPDATE`

Tool to create a new status update on a project. Use when you need to communicate the current status, progress, or any blockers related to a specific project.

### Create a section in a project

**Slug:** `ASANA_CREATE_SECTION_IN_PROJECT`

Creates a new SECTION (not a task) in a project. Sections are organizational containers within a project used to group and categorize tasks (e.g., 'To Do', 'In Progress', 'Done', 'Backlog'). The new section can be optionally positioned relative to an existing section in the same project. IMPORTANT: This action creates SECTIONS only. Do NOT use this action to create tasks. To create a task, use the ASANA_CREATE_A_TASK action instead. Task-related fields like 'assignee', 'notes', 'due_date', 'description' are NOT supported by this action.

### Create Status Update for Object

**Slug:** `ASANA_CREATE_STATUS_FOR_OBJECT`

Tool to create a status update on a project, portfolio, or goal. Use when you need to communicate progress, blockers, or current state to all followers of an object.

### Create subtask

**Slug:** `ASANA_CREATE_SUBTASK`

Creates a new Asana subtask under an existing parent task (`task_gid`); `due_on` and `due_at` are mutually exclusive and cannot be set simultaneously.

### Create a tag

**Slug:** `ASANA_CREATE_TAG`

Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks. Tags help organize and filter tasks across projects but are not automatically applied to any tasks.

### Create task comment

**Slug:** `ASANA_CREATE_TASK_COMMENT`

Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.

### Create Team

**Slug:** `ASANA_CREATE_TEAM`

Tool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.

### Delete Allocation

**Slug:** `ASANA_DELETE_ALLOCATION`

Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.

### Delete Attachment

**Slug:** `ASANA_DELETE_ATTACHMENT`

Tool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.

### Delete Custom Field

**Slug:** `ASANA_DELETE_CUSTOM_FIELD`

Tool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.

### Delete Membership

**Slug:** `ASANA_DELETE_MEMBERSHIP`

Tool to delete a membership by its GID. Use this when you need to remove a user or team's access to a project, portfolio, goal, or custom field in Asana.

### Delete a project

**Slug:** `ASANA_DELETE_PROJECT`

Delete a project.

### Delete Project Brief

**Slug:** `ASANA_DELETE_PROJECT_BRIEF`

Tool to delete a project brief by its GID. Use when you need to remove a project brief from Asana. Note: This requires the project_brief_gid (not the project_gid).

### Delete Project Status

**Slug:** `ASANA_DELETE_PROJECT_STATUS`

Tool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.

### Delete a section

**Slug:** `ASANA_DELETE_SECTION`

Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.

### Delete Status Update

**Slug:** `ASANA_DELETE_STATUS_UPDATE`

Tool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.

### Delete Story

**Slug:** `ASANA_DELETE_STORY`

Tool to delete a story by its GID. Use when you need to remove a story from Asana.

### Delete a Tag

**Slug:** `ASANA_DELETE_TAG`

Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.

### Delete a task

**Slug:** `ASANA_DELETE_TASK`

Delete a task.

### Duplicate Project

**Slug:** `ASANA_DUPLICATE_PROJECT`

Duplicate a project.

### Duplicate Task

**Slug:** `ASANA_DUPLICATE_TASK`

Duplicate a task

### Get Access Requests

**Slug:** `ASANA_GET_ACCESS_REQUESTS`

Tool to retrieve access requests for a target object. Use when you need to get pending access requests for a specific resource like a project or portfolio.

### Get Allocation

**Slug:** `ASANA_GET_ALLOCATION`

Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.

### Get Allocations

**Slug:** `ASANA_GET_ALLOCATIONS`

Tool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.

### Get a project

**Slug:** `ASANA_GET_A_PROJECT`

Retrieves a specific Asana project by its `project_gid`, with an option to include additional fields for comprehensive details using `opt_fields`; this action does not return tasks within the project.

### Get a task

**Slug:** `ASANA_GET_A_TASK`

Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.

### Get Attachment

**Slug:** `ASANA_GET_ATTACHMENT`

Tool to get a single attachment by its globally unique identifier. Use when you need to retrieve details about a specific file attached to a task or project.

### Get Audit Log Events

**Slug:** `ASANA_GET_AUDIT_LOG_EVENTS`

Tool to get audit log events for a workspace. Use when you need to retrieve a log of actions performed within a specific Asana workspace.

### Get a user task list

**Slug:** `ASANA_GET_A_USER_TASK_LIST`

Retrieves a specific user's task list from Asana by its `user_task_list_gid`, optionally returning extended details like name, owner, and workspace if specified in `opt_fields`.

### Get current user

**Slug:** `ASANA_GET_CURRENT_USER`

Retrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.

### Get Custom Field

**Slug:** `ASANA_GET_CUSTOM_FIELD`

Tool to get a single custom field by its globally unique identifier. Use when you need to retrieve the complete metadata and properties of a specific custom field in Asana.

### Get Custom Fields for Workspace

**Slug:** `ASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACE`

Tool to get all custom fields in a workspace. Use when you need to retrieve a list of custom fields associated with a specific workspace.

### Get Custom Types

**Slug:** `ASANA_GET_CUSTOM_TYPES`

Tool to get all custom types associated with a project. Use when you need to retrieve custom types that extend Asana objects for categorization purposes.

### Get Events on a Resource

**Slug:** `ASANA_GET_EVENTS`

Retrieve events on a resource to monitor changes. Use when you need to track activity or changes related to a specific Asana resource like a task, project, or tag.

### Get Favorites for User

**Slug:** `ASANA_GET_FAVORITES_FOR_USER`

Tool to get a user's favorites within a specified workspace. Returns favorites ordered as they appear in the user's Asana sidebar.

### Get Goal

**Slug:** `ASANA_GET_GOAL`

Retrieve the full record for a single goal by its GID.

### Get Goal Relationships

**Slug:** `ASANA_GET_GOAL_RELATIONSHIPS`

Tool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.

### Get Goals

**Slug:** `ASANA_GET_GOALS`

Tool to retrieve multiple goals. Requires exactly one scope parameter (workspace, team, portfolio, or project) to be specified. Can be optionally filtered by time period or archived status.

### Get Job

**Slug:** `ASANA_GET_JOB`

Tool to retrieve a job by its globally unique identifier. Use when you need to check the status of asynchronous operations like task duplication, project instantiation, or exports.

### Get Membership

**Slug:** `ASANA_GET_MEMBERSHIP`

Tool to retrieve a single membership by its ID. Use this when you need to get details about a specific membership relationship between a user/team and a goal, project, portfolio, or custom field.

### Get Memberships

**Slug:** `ASANA_GET_MEMBERSHIPS`

Tool to retrieve memberships for goals, projects, portfolios, or custom fields. Use this to find out who has access to a specific Asana resource or what resources a specific user/team has access to.

### Get multiple projects

**Slug:** `ASANA_GET_MULTIPLE_PROJECTS`

Returns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.

### Get multiple tasks

**Slug:** `ASANA_GET_MULTIPLE_TASKS`

Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`; `workspace` also requires `assignee`.

### Get multiple users

**Slug:** `ASANA_GET_MULTIPLE_USERS`

Returns a list of users in an Asana workspace or organization, optionally filtered by workspace or team GID, with support for pagination and specifying optional fields.

### Get multiple workspaces

**Slug:** `ASANA_GET_MULTIPLE_WORKSPACES`

Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.

### Get Portfolio

**Slug:** `ASANA_GET_PORTFOLIO`

Retrieve the full record for a single portfolio by its GID. Use this when you need to get detailed information about a specific portfolio.

### Get Portfolio Items

**Slug:** `ASANA_GET_PORTFOLIO_ITEMS`

Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.

### Get Portfolio Memberships

**Slug:** `ASANA_GET_PORTFOLIO_MEMBERSHIPS`

Tool to retrieve multiple portfolio memberships. Use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.

### Get Portfolios

**Slug:** `ASANA_GET_PORTFOLIOS`

Retrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.

### Get Project Brief

**Slug:** `ASANA_GET_PROJECT_BRIEF`

Tool to retrieve a project brief by its GID. Use when you need to get the detailed explanation (what and why) of a project. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

### Get Project Membership

**Slug:** `ASANA_GET_PROJECT_MEMBERSHIP`

Tool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.

### Get Project Memberships

**Slug:** `ASANA_GET_PROJECT_MEMBERSHIPS`

Tool to retrieve memberships from a specific project. Returns the compact project membership records for the project.

### Get Project Memberships For Project

**Slug:** `ASANA_GET_PROJECT_MEMBERSHIPS_FOR_PROJECT`

Tool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.

### Get Projects for Task

**Slug:** `ASANA_GET_PROJECTS_FOR_TASK`

Tool to get all projects a task is in. Use when you need to retrieve project associations for a specific task.

### Get Projects for Team

**Slug:** `ASANA_GET_PROJECTS_FOR_TEAM`

Tool to get a list of projects for a specific team in Asana. Use when you need to retrieve project details associated with a team.

### Get Project Status

**Slug:** `ASANA_GET_PROJECT_STATUS`

Tool to retrieve the full record for a single project status by its GID. Use when you need to get the details of a specific project status update.

### Get Project Status Updates

**Slug:** `ASANA_GET_PROJECT_STATUS_UPDATES`

Tool to get status updates for a specific project. Use when you need to retrieve the latest or historical status reports associated with an Asana project.

### Get Multiple Project Templates

**Slug:** `ASANA_GET_PROJECT_TEMPLATES`

Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.

### Get Project Templates for Team

**Slug:** `ASANA_GET_PROJECT_TEMPLATES_FOR_TEAM`

Tool to get a team's project templates in Asana. Use when you need to retrieve project templates associated with a specific team.

### Get Reactions on Object

**Slug:** `ASANA_GET_REACTIONS_ON_OBJECT`

Tool to get reactions with a specific emoji base character on an object. Use when you need to retrieve user reactions (emoji responses) on a status update or story.

### Get Section

**Slug:** `ASANA_GET_SECTION`

Retrieve the full record for a single section by its GID. Use this when you need to get details about a specific section within a project.

### Get sections in a project

**Slug:** `ASANA_GET_SECTIONS_IN_PROJECT`

Returns compact records for all sections (used to group tasks) in a specified project.

### Get Status Update

**Slug:** `ASANA_GET_STATUS`

Tool to retrieve the full record for a single status update by its GID. Use when you need to get the details of a specific status update.

### Get Status Updates

**Slug:** `ASANA_GET_STATUS_UPDATES`

Retrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.

### Get Stories for Task

**Slug:** `ASANA_GET_STORIES_FOR_TASK`

Tool to get stories (comments, status updates, etc.) for a task. Use when you need to retrieve the history or discussion associated with a specific task.

### Get Story

**Slug:** `ASANA_GET_STORY`

Tool to retrieve a story. Use when you need to get the complete record for a single story.

### Get Tag

**Slug:** `ASANA_GET_TAG`

Tool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.

### Get Tags

**Slug:** `ASANA_GET_TAGS`

Get multiple tags in a workspace.

### Get Tags for Task

**Slug:** `ASANA_GET_TAGS_FOR_TASK`

Tool to get all tags associated with a specific task. Use when you need to retrieve tags for categorization, filtering, or understanding task organization.

### Get Tags For Workspace

**Slug:** `ASANA_GET_TAGS_FOR_WORKSPACE`

Tool to get all tags in a specific workspace. Use when you need to retrieve tags for categorizing tasks within a workspace.

### Get Task Attachments

**Slug:** `ASANA_GET_TASK_ATTACHMENTS`

Tool to get the list of attachments for a given task, project, or project_brief. Use when you need to retrieve files attached to a specific Asana object.

### Get Task Counts For Project

**Slug:** `ASANA_GET_TASK_COUNTS_FOR_PROJECT`

Tool to get task count statistics for a project. Use when you need to retrieve the number of tasks, completed tasks, incomplete tasks, and milestone counts for a specific Asana project. Note that all fields are excluded by default - you must specify them in opt_fields to get any data.

### Get tasks for tag

**Slug:** `ASANA_GET_TASKS_FOR_TAG`

Tool to retrieve tasks associated with a specific Asana tag by tag GID. Use when you need to list all tasks that have been tagged with a particular label.

### Get tasks for user task list

**Slug:** `ASANA_GET_TASKS_FOR_USER_TASK_LIST`

Tool to retrieve tasks from a user task list by user task list GID. Use when you need to list tasks assigned to a specific user's task list.

### Retrieve tasks for project

**Slug:** `ASANA_GET_TASKS_FROM_A_PROJECT`

Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.

### Get tasks from a section

**Slug:** `ASANA_GET_TASKS_FROM_A_SECTION`

Tool to retrieve tasks that belong to a specific Asana section (column/header) by section GID. Use when you need to list tasks within a particular section, such as for agenda or carryover workflows. Board view only feature.

### Get Task Subtasks

**Slug:** `ASANA_GET_TASK_SUBTASKS`

Tool to retrieve multiple task subtasks from a workspace. Use when you need to list or find available task subtasks.

### Get Task Templates

**Slug:** `ASANA_GET_TASK_TEMPLATES`

Tool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.

### Get Team

**Slug:** `ASANA_GET_TEAM`

Tool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.

### Get Team Membership

**Slug:** `ASANA_GET_TEAM_MEMBERSHIP`

Tool to retrieve a complete team membership record by its GID. Use when you need to fetch details about a specific team membership in Asana.

### Get Team Memberships

**Slug:** `ASANA_GET_TEAM_MEMBERSHIPS`

Tool to retrieve compact team membership records. Use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.

### Get Team Memberships for Team

**Slug:** `ASANA_GET_TEAM_MEMBERSHIPS_FOR_TEAM`

Tool to get memberships from a specific team. Use when you need to retrieve the list of users who are members of a particular team, including their membership details such as admin status and guest status.

### Get Team Memberships For User

**Slug:** `ASANA_GET_TEAM_MEMBERSHIPS_FOR_USER`

Tool to get team memberships for a specific user. Use when you need to retrieve all teams that a user belongs to within a workspace.

### Get Teams for User

**Slug:** `ASANA_GET_TEAMS_FOR_USER`

Tool to get teams for a specific user in an organization. Returns the team records for all teams in the organization or workspace to which the given user is assigned.

### Get teams in workspace

**Slug:** `ASANA_GET_TEAMS_IN_WORKSPACE`

Returns the compact records for all teams in the workspace visible to the authorized user.

### Get Time Period

**Slug:** `ASANA_GET_TIME_PERIOD`

Tool to retrieve the full record for a single time period by its GID. Use when you need to fetch detailed information about a specific time period, including its start/end dates, display name, and parent period.

### Get Time Periods

**Slug:** `ASANA_GET_TIME_PERIODS`

Tool to retrieve compact or full representations of time periods. Use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.

### Get Time Tracking Entries

**Slug:** `ASANA_GET_TIME_TRACKING_ENTRIES`

Tool to get multiple time tracking entries across workspace, tasks, or projects. Use when you need to retrieve time tracking information for filtering by workspace, task, portfolio, user, or date range.

### Get Time Tracking Entries for Task

**Slug:** `ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TASK`

Tool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.

### Get Objects via Typeahead

**Slug:** `ASANA_GET_TYPEAHEAD_OBJECTS`

Tool to retrieve objects in a workspace via a typeahead search algorithm. Use when you need to quickly find objects like tasks, projects, users, etc., based on a search string. This is useful for implementing auto-completion features.

### Get User

**Slug:** `ASANA_GET_USER`

Get a user by their ID.

### Get User in Workspace

**Slug:** `ASANA_GET_USER_FOR_WORKSPACE`

Tool to get a user in a workspace or organization by their GID. Use when you need to retrieve details about a specific user within a workspace context.

### Get Users for Team

**Slug:** `ASANA_GET_USERS_FOR_TEAM`

Get users in a team.

### Get Users in Workspace

**Slug:** `ASANA_GET_USERS_FOR_WORKSPACE`

Get users in a workspace or organization.

### Get User Task List

**Slug:** `ASANA_GET_USER_TASK_LIST`

Tool to get a single user task list by its globally unique identifier. Use when you need to retrieve information about a specific user's My Tasks list.

### Get Webhooks

**Slug:** `ASANA_GET_WEBHOOKS`

Tool to retrieve multiple webhooks in a workspace. Use when you need to list all webhooks for a workspace or filter webhooks by a specific resource.

### Get Workspace

**Slug:** `ASANA_GET_WORKSPACE`

Tool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.

### Get Workspace Membership

**Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIP`

Tool to retrieve a specific workspace membership by its GID. Use when you need to get details about a user's membership in a workspace.

### Get Workspace Memberships

**Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIPS`

Tool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.

### Get Workspace Memberships For User

**Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIPS_FOR_USER`

Tool to retrieve workspace memberships for a specific user. Use when you need to list all workspaces a user is a member of.

### Get Workspace Projects

**Slug:** `ASANA_GET_WORKSPACE_PROJECTS`

Tool to retrieve the projects associated with a specific workspace. Use when you need to list all projects within a given Asana workspace.

### Reorder Enum Option for Custom Field

**Slug:** `ASANA_INSERT_ENUM_OPTION_FOR_CUSTOM_FIELD`

Tool to reorder an existing enum option within a custom field by moving it before or after another specified enum option. Use when you need to change the order/position of options in an enum or multi_enum custom field. Note: To create new enum options, use 'Create Enum Option for Custom Field' action instead.

### Move or Insert Section in Project

**Slug:** `ASANA_INSERT_SECTION_FOR_PROJECT`

Tool to move or reorder an existing section within a project by repositioning it before or after another section. Use when you need to change the position/order of sections in a project. Note: This action moves existing sections only. To create new sections, use 'Create Section in Project' action instead.

### Instantiate Project Template

**Slug:** `ASANA_INSTANTIATE_PROJECT_TEMPLATE`

Instantiate (create) a real Asana project from a project template, returning the async job record. Use when you need to create a new project from a template with specific date and role assignments.

### Reject access request

**Slug:** `ASANA_REJECT_ACCESS_REQUEST`

Tool to reject an access request. Use when you need to deny a user's request for access to a project or resource.

### Remove Follower From Task

**Slug:** `ASANA_REMOVE_FOLLOWER_FROM_TASK`

Tool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.

### Remove Followers For Project

**Slug:** `ASANA_REMOVE_FOLLOWERS_FOR_PROJECT`

Tool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.

### Remove Item from Portfolio

**Slug:** `ASANA_REMOVE_ITEM_FROM_PORTFOLIO`

Tool to remove an item (e.g., a project) from an Asana portfolio. Use to undo/cleanup portfolio membership, support moves between portfolios, or enforce portfolio hygiene.

### Remove Members from Project

**Slug:** `ASANA_REMOVE_MEMBERS_FOR_PROJECT`

Tool to remove users from a project in Asana. Use this tool when you need to remove one or more users as members from a specific project.

### Remove Project from Task

**Slug:** `ASANA_REMOVE_PROJECT_FROM_TASK`

Tool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.

### Remove Tag from Task

**Slug:** `ASANA_REMOVE_TAG_FROM_TASK`

Tool to remove an existing tag from a task in Asana. Use this tool when you need to detach a tag from a specific task for cleanup or retagging automation.

### Remove User For Team

**Slug:** `ASANA_REMOVE_USER_FOR_TEAM`

Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.

### Remove User from Workspace

**Slug:** `ASANA_REMOVE_USER_FOR_WORKSPACE`

Tool to remove a user from a workspace or organization. Use when you need to revoke a user's access to a specific workspace.

### Search Tasks in Workspace

**Slug:** `ASANA_SEARCH_TASKS_IN_WORKSPACE`

Tool to search tasks across a workspace with advanced filters. Use when performing complex queries such as overdue tasks, by project or custom field, for reporting or automation.

### Set parent for task

**Slug:** `ASANA_SET_PARENT_FOR_TASK`

Tool to set the parent of a task in Asana. Use when you need to make a task a subtask of another task or remove the parent relationship.

### Submit Parallel Requests (Batch API)

**Slug:** `ASANA_SUBMIT_PARALLEL_REQUESTS`

Tool to submit multiple Asana API requests in parallel using the Batch API. Use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.

### Update Allocation

**Slug:** `ASANA_UPDATE_ALLOCATION`

Tool to update an existing allocation by its ID. Use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.

### Update a task

**Slug:** `ASANA_UPDATE_A_TASK`

Updates attributes of an existing Asana task identified by its task_gid.

### Update Custom Field

**Slug:** `ASANA_UPDATE_CUSTOM_FIELD`

Tool to update a custom field by its globally unique identifier. Use when you need to modify properties of an existing custom field in Asana.

### Update Enum Option

**Slug:** `ASANA_UPDATE_ENUM_OPTION`

Tool to update an enum option for a custom field. Use when you need to modify the name, color, or enabled status of an existing enum option.

### Update a project

**Slug:** `ASANA_UPDATE_PROJECT`

Update a project.

### Update Project Brief

**Slug:** `ASANA_UPDATE_PROJECT_BRIEF`

Tool to update a project brief by its GID. Use when you need to modify the content/description of a project brief. Note: Requires the project_brief_gid (not the project_gid). First call 'Get a project' with opt_fields=['project_brief'] to obtain the project_brief_gid.

### Update Section

**Slug:** `ASANA_UPDATE_SECTION`

Update a section's name or position within a project. Use when you need to rename a section or reorder sections by specifying insert_before or insert_after.

### Update Story

**Slug:** `ASANA_UPDATE_STORY`

Tool to update a story on a task. Use when you need to modify the text, html_text, or pin status of an existing story. Only comment stories can have text/html_text updated, and only comment and attachment stories can be pinned.

### Update Tag

**Slug:** `ASANA_UPDATE_TAG`

Tool to update an existing tag by its globally unique identifier. Use when you need to change the name or color of a tag.

### Update a team

**Slug:** `ASANA_UPDATE_TEAM`

Tool to update details of an existing team. Use when you need to change a team's name, description, or organization.

### Update User

**Slug:** `ASANA_UPDATE_USER`

Update a user's custom fields. Note: Asana's API has very limited user update capabilities - most user properties are read-only and managed by users themselves.

### Update User for Workspace

**Slug:** `ASANA_UPDATE_USER_FOR_WORKSPACE`

Tool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.

### Update a webhook

**Slug:** `ASANA_UPDATE_WEBHOOK`

Tool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.


## Triggers

### Task Trigger

**Slug:** `ASANA_TASK_TRIGGER`

Task Trigger
