Asana

Tool to help teams organize, track, and manage their work. asana · 153 tools · 6 triggers

Connect it

run auth asana
run auth asana --scope team    # shared with the organization

Or from the Integrations page in the console. See Connections for personal versus shared, and who may remove one.

Use it

run asana          # common commands
run asana --all    # every command

import { asana } from "@boxd/run";

Common tools

Tool	What it does
`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.
`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.
`add-item-to-portfolio`	Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint.
`add-members-to-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.
`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.
`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…
`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.
`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…
`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-to-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-to-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…
`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-attachment-for-object`	Tool to upload an attachment or link an external resource to a task, project, or project_brief in 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`	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`	Tool to create a new enum option for a custom field in Asana.
`create-membership`	Tool to create a membership by adding a user or team to a project, goal, or portfolio.
`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`	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`	Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace.
`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-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…
`create-status-for-object`	Tool to create a status update on a project, portfolio, or goal.
`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-tag`	Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks.

All 152 tools

Tool	What it does
`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.
`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.
`add-item-to-portfolio`	Add a project (or other supported item) to an Asana portfolio using the native addItem endpoint.
`add-members-to-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.
`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.
`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…
`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.
`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…
`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-to-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-to-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…
`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`	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`	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-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-tag-in-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…
`create-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`	Tool to upload an attachment or link an external resource to a task, project, or project_brief in 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`	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`	Tool to create a new enum option for a custom field in Asana.
`create-membership`	Tool to create a membership by adding a user or team to a project, goal, or portfolio.
`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`	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`	Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace.
`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-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…
`create-status-for-object`	Tool to create a status update on a project, portfolio, or goal.
`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-tag`	Tool to create a new tag in an Asana workspace. Use when you need to create a tag for categorizing tasks.
`create-task-comment`	Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.
`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`	Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.
`delete-attachment`	Tool to delete an attachment by its globally unique identifier.
`delete-custom-field`	Tool to delete a custom field by its globally unique identifier.
`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-project`	Delete a project.
`delete-project-brief`	Tool to delete a project brief by its GID. Use when you need to remove a project brief from 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-section`	Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.
`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`	Tool to delete a story by its GID. Use when you need to remove a story from Asana.
`delete-tag`	Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.
`delete-task`	Delete a task.
`duplicate-project`	Duplicate a project.
`duplicate-task`	Duplicate a task
`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`	Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.
`get-allocations`	Tool to get multiple allocations. Requires either ‘parent’ (project GID) OR both ‘assignee’ AND ‘workspace’ together.
`get-project`	Retrieves a specific Asana project by its `project_gid`, with an option to include additional fields for comprehensive details using `opt_fields`…
`get-task`	Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.
`get-attachment`	Tool to get a single attachment by its globally unique identifier.
`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-user-task-list`	Tool to get a single user task list by its globally unique identifier.
`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`	Tool to get a single custom field by its globally unique identifier.
`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`	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`	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`	Tool to get a user’s favorites within a specified workspace.
`get-goal`	Retrieve the full record for a single goal by its GID.
`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`	Tool to retrieve multiple goals. Requires exactly one scope parameter (workspace, team, portfolio, or project) to be specified.
`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…
`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…
`get-memberships`	Tool to retrieve memberships for goals, projects, portfolios, or custom fields.
`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`	Retrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`…
`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`	Retrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.
`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`	Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.
`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…
`get-portfolios`	Retrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.
`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.
`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`	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`	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`	Tool to get a list of projects for a specific team in Asana.
`get-project-status`	Tool to retrieve the full record for a single project status by its GID.
`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-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`	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`	Tool to get reactions with a specific emoji base character on an object.
`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-project`	Returns compact records for all sections (used to group tasks) in a specified project.
`get-status`	Tool to retrieve the full record for a single status update by its GID.
`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`	Tool to get stories (comments, status updates, etc.) for a task.
`get-story`	Tool to retrieve a story. Use when you need to get the complete record for a single story.
`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`	Get multiple tags in a workspace.
`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`	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`	Tool to get the list of attachments for a given task, project, or project_brief.
`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…
`get-tasks-for-tag`	Tool to retrieve tasks associated with a specific Asana tag by tag GID.
`get-tasks-for-user-task-list`	Tool to retrieve tasks from a user task list by user task list GID.
`get-tasks-from-project`	Retrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.
`get-tasks-from-section`	Tool to retrieve tasks that belong to a specific Asana section (column/header) by section GID.
`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`	Tool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.
`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`	Tool to retrieve a complete team membership record by its GID.
`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`	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…
`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`	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`	Returns the compact records for all teams in the workspace visible to the authorized user.
`get-time-period`	Tool to retrieve the full record for a single time period by its GID.
`get-time-periods`	Tool to retrieve compact or full representations of time periods.
`get-time-tracking-entries`	Tool to get multiple time tracking entries across workspace, tasks, or projects.
`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-typeahead-objects`	Tool to retrieve objects in a workspace via a typeahead search algorithm.
`get-user`	Get a user by their ID.
`get-user-for-workspace`	Tool to get a user in a workspace or organization by their GID.
`get-users-for-team`	Get users in a team.
`get-users-for-workspace`	Get users in a workspace or organization.
`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`	Tool to retrieve details of a specific workspace by its GID.
`get-workspace-membership`	Tool to retrieve a specific workspace membership by its GID.
`get-workspace-memberships`	Tool to retrieve the workspace memberships for a specific workspace.
`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`	Tool to retrieve the projects associated with a specific workspace.
`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.
`insert-section-for-project`	Tool to move or reorder an existing section within a project by repositioning it before or after another section.
`instantiate-project-template`	Instantiate (create) a real Asana project from a project template, returning the async job record.
`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`	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`	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`	Tool to remove an item (e.g., a project) from an Asana portfolio.
`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`	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`	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`	Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.
`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`	Tool to search tasks across a workspace with advanced filters.
`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`	Tool to submit multiple Asana API requests in parallel using the Batch API.
`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-task`	Updates attributes of an existing Asana task identified by its task_gid.
`update-custom-field`	Tool to update a custom field by its globally unique identifier.
`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-project`	Update a project.
`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.
`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`	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.
`update-tag`	Tool to update an existing tag by its globally unique identifier.
`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`	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`	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-webhook`	Tool to update an existing Asana webhook’s filter configuration.

Triggers (6)

Subscribe with .on(...) in a script. A trigger with required configuration takes it as the second argument.

Trigger	Needs	What fires it
Attachment Added to Task	`project_gid`	Triggers when an attachment is added to a task.
New Comment on Task	`project_gid`	Triggers when a comment is added to a task in a project.
New Task Created	`project_gid`	Triggers when a new task is created in a project.
Task Moved to Section	`project_gid`	Triggers when a task is moved to a section in a project.
Tag Added to Task	`project_gid`	Triggers when a tag is added to a task.
Task Updated	`project_gid`	Triggers when a task is updated in a project.

Open Asana in the console →

Getting started

Guides

Integrations & automations

Use cases

References

Connect it

Use it

Common tools

Triggers (6)

​Connect it

​Use it

​Common tools

​Triggers (6)

Connect it

Use it

Common tools

Triggers (6)