> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # Asana > Tool to help teams organize, track, and manage their work Tool to help teams organize, track, and manage their work. `asana` · **153 tools** · **6 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth asana run auth asana --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run asana # common commands run asana --all # every command ``` ```ts theme={"theme":"github-dark"} 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. | | 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 →](https://app.boxd.sh/integrations/detail/asana)