- Category: project management
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 157
- Triggers: 6
- Slug:
ASANA - Version: 20261101_00
Frequently Asked Questions
How do I set up custom OAuth credentials for Asana?
How do I set up custom OAuth credentials for Asana?
Tools
Add a custom field to a goal
Add a custom field to a goal
ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_GOALAdd a custom field to a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Add a custom field to a portfolio
Add a custom field to a portfolio
ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PORTFOLIOAdd a custom field to a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Add a custom field to a project
Add a custom field to a project
ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PROJECTAdd a custom field to a project.Input Parameters
Output
Add a collaborator to a goal
Add a collaborator to a goal
ASANA_ADD_FOLLOWERS_TO_GOALAdd a collaborator to a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Add Followers to Project
Add Followers to Project
ASANA_ADD_FOLLOWERS_TO_PROJECTTool 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.Input Parameters
Output
Add Followers to Task
Add Followers to Task
ASANA_ADD_FOLLOWERS_TO_TASKTool 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.Input Parameters
Output
Add item to portfolio
Add item to portfolio
ASANA_ADD_ITEM_TO_PORTFOLIOAdd 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.Input Parameters
insert_before.insert_after.Output
Add users to a portfolio
Add users to a portfolio
ASANA_ADD_MEMBERS_FOR_PORTFOLIOAdd users to a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Add Members to Project
Add Members to Project
ASANA_ADD_MEMBERS_TO_PROJECTTool 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.Input Parameters
Output
Add Project to Task
Add Project to Task
ASANA_ADD_PROJECT_FOR_TASKTool 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.Input Parameters
insert_before: null (end of section) or insert_after: null (beginning of section). Can also be combined with non-null insert_before or insert_after to position relative to a task within the section.null to insert at the beginning of the list. When used with section, null will insert at the beginning of the specified section, otherwise the task must be in the specified section.null to insert at the end of the list. When used with section, null will insert at the end of the specified section, otherwise the task must be in the specified section.Output
Add Supporting Relationship to Goal
Add Supporting Relationship to Goal
ASANA_ADD_SUPPORTING_RELATIONSHIPTool 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.Input Parameters
Output
Add Tag to Task
Add Tag to Task
ASANA_ADD_TAG_TO_TASKTool 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.Input Parameters
Output
Add Task Dependencies
Add Task Dependencies
ASANA_ADD_TASK_DEPENDENCIESTool 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.Input Parameters
Output
Add Task Dependents
Add Task Dependents
ASANA_ADD_TASK_DEPENDENTSMark tasks as dependents of an Asana prerequisite task, if not already linked. A task can have at most 30 dependents and dependencies combined. This adds relationships without creating or deleting tasks.Input Parameters
Output
Add task to section
Add task to section
ASANA_ADD_TASK_TO_SECTIONAdds 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.Input Parameters
Output
Add User for Team
Add User for Team
ASANA_ADD_USER_TO_TEAMTool 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.Input Parameters
Output
Add User for Workspace
Add User for Workspace
ASANA_ADD_USER_TO_WORKSPACETool 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.Input Parameters
Output
Approve Access Request
Approve Access Request
ASANA_APPROVE_ACCESS_REQUESTTool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.Input Parameters
Output
Create Access Request
Create Access Request
ASANA_CREATE_ACCESS_REQUESTTool 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.Input Parameters
Output
Create Allocation
Create Allocation
ASANA_CREATE_ALLOCATIONCreates an allocation for a user in a workspace over a defined period, with an effort value in hours or percent and an optional project association.Input Parameters
Output
Create a project
Create a project
Create a tag in a workspace
Create a tag in a workspace
ASANA_CREATE_A_TAG_IN_A_WORKSPACECreates 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.Input Parameters
OptFieldsEnm0 (e.g., ‘name’, ‘color’) to include in the response; returns a compact representation by default.Output
Create task in asana with specific details
Create task in asana with specific details
ASANA_CREATE_A_TASKCreates a new Asana task; requires ‘workspace’, ‘parent’, or ‘projects’ for association, and ‘followers’, ‘projects’, ‘tags’ are set only at creation.Input Parameters
Output
Create Attachment for Object
Create Attachment for Object
ASANA_CREATE_ATTACHMENT_FOR_OBJECTTool 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.Input Parameters
Output
Create Attachment for Task
Create Attachment for Task
ASANA_CREATE_ATTACHMENT_FOR_TASKTool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.Input Parameters
Output
Create a budget
Create a budget
ASANA_CREATE_BUDGETCreate a budget.Input Parameters
Output
Create Custom Field
Create Custom Field
Create Enum Option for Custom Field
Create Enum Option for Custom Field
Create a goal
Create a goal
ASANA_CREATE_GOALCreate a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Create a goal metric
Create a goal metric
ASANA_CREATE_GOAL_METRICCreate a goal metric. Requires an Asana subscription with Goals access.Input Parameters
Output
Create Membership
Create Membership
ASANA_CREATE_MEMBERSHIPTool 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.Input Parameters
Output
Create an OOO entry
Create an OOO entry
ASANA_CREATE_OOO_ENTRYCreate an OOO entry.Input Parameters
Output
Create a portfolio
Create a portfolio
ASANA_CREATE_PORTFOLIOCreate a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Create Project Brief
Create Project Brief
ASANA_CREATE_PROJECT_BRIEFTool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.Input Parameters
Output
Create project for team
Create project for team
ASANA_CREATE_PROJECT_FOR_TEAMTool to create a project in a team. Use when you need to create a new project within a specific Asana team.Input Parameters
Output
Create project for workspace
Create project for workspace
ASANA_CREATE_PROJECT_FOR_WORKSPACETool 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.Input Parameters
Output
Create Project Status Update
Create Project Status Update
ASANA_CREATE_PROJECT_STATUS_UPDATETool 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.Input Parameters
Output
Create a rate
Create a rate
ASANA_CREATE_RATECreate a rate.Input Parameters
Output
Create a role
Create a role
ASANA_CREATE_ROLECreate a role.Input Parameters
Output
Create a section in a project
Create a section in a project
ASANA_CREATE_SECTION_IN_PROJECTCreates 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.Input Parameters
insert_before is also omitted), the new section is added at the end.Output
Create Status Update for Object
Create Status Update for Object
ASANA_CREATE_STATUS_FOR_OBJECTTool 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.Input Parameters
Output
Create a story on a goal
Create a story on a goal
ASANA_CREATE_STORY_FOR_GOALCreate a story on a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Create subtask
Create subtask
ASANA_CREATE_SUBTASKCreates a new Asana subtask under an existing parent task (task_gid); due_on and due_at are mutually exclusive and cannot be set simultaneously.Input Parameters
due_on.Output
Create a tag
Create a tag
ASANA_CREATE_TAGTool 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.Input Parameters
Output
Create task comment
Create task comment
ASANA_CREATE_TASK_COMMENTAdds a new text comment (story) to an existing Asana task, appearing in its activity feed.Input Parameters
Output
Create Team
Create Team
Create a timesheet approval status
Create a timesheet approval status
ASANA_CREATE_TIMESHEET_APPROVAL_STATUSCreate a timesheet approval status.Input Parameters
Output
Create a time tracking category
Create a time tracking category
ASANA_CREATE_TIME_TRACKING_CATEGORYCreate a time tracking category.Input Parameters
Output
Create a time tracking entry
Create a time tracking entry
ASANA_CREATE_TIME_TRACKING_ENTRYCreate a time tracking entry.Input Parameters
Output
Delete Allocation
Delete Allocation
ASANA_DELETE_ALLOCATIONTool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.Input Parameters
Output
Delete Attachment
Delete Attachment
Delete a budget
Delete a budget
ASANA_DELETE_BUDGETDelete a budget.Input Parameters
Output
Delete Custom Field
Delete Custom Field
Delete a goal
Delete a goal
ASANA_DELETE_GOALDelete a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Delete Membership
Delete Membership
ASANA_DELETE_MEMBERSHIPTool 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.Input Parameters
Output
Delete an OOO entry
Delete an OOO entry
ASANA_DELETE_OOO_ENTRYDelete an OOO entry.Input Parameters
Output
Delete a portfolio
Delete a portfolio
ASANA_DELETE_PORTFOLIODelete a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Delete a project
Delete a project
ASANA_DELETE_PROJECTDelete a project.Input Parameters
Output
Delete Project Brief
Delete Project Brief
ASANA_DELETE_PROJECT_BRIEFTool 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).Input Parameters
Output
Delete Project Status
Delete Project Status
ASANA_DELETE_PROJECT_STATUSTool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.Input Parameters
Output
Delete a project template
Delete a project template
ASANA_DELETE_PROJECT_TEMPLATEDelete a project template.Input Parameters
Output
Delete a rate
Delete a rate
ASANA_DELETE_RATEDelete a rate.Input Parameters
Output
Delete a role
Delete a role
ASANA_DELETE_ROLEDelete a role.Input Parameters
Output
Delete a section
Delete a section
ASANA_DELETE_SECTIONTool to delete a section by its GID. Use when you need to permanently remove a section from a project.Input Parameters
Output
Delete Status Update
Delete Status Update
ASANA_DELETE_STATUS_UPDATETool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.Input Parameters
Output
Delete Story
Delete Story
ASANA_DELETE_STORYTool to delete a story by its GID. Use when you need to remove a story from Asana.Input Parameters
Output
Delete a Tag
Delete a Tag
ASANA_DELETE_TAGTool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.Input Parameters
Output
Delete a task
Delete a task
ASANA_DELETE_TASKDelete a task.Input Parameters
Output
Delete a task template
Delete a task template
ASANA_DELETE_TASK_TEMPLATEDelete a task template.Input Parameters
Output
Delete a time tracking category
Delete a time tracking category
ASANA_DELETE_TIME_TRACKING_CATEGORYDelete a time tracking category.Input Parameters
Output
Delete a time tracking entry
Delete a time tracking entry
ASANA_DELETE_TIME_TRACKING_ENTRYDelete a time tracking entry.Input Parameters
Output
Delete a webhook
Delete a webhook
ASANA_DELETE_WEBHOOKDelete a webhook.Input Parameters
Output
Duplicate a portfolio
Duplicate a portfolio
ASANA_DUPLICATE_PORTFOLIODuplicate a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Duplicate Project
Duplicate Project
Duplicate Task
Duplicate Task
Get Access Requests
Get Access Requests
ASANA_GET_ACCESS_REQUESTSTool 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.Input Parameters
Output
Get AI Studio credit utilization
Get AI Studio credit utilization
ASANA_GET_AI_STUDIO_RUNSGet AI Studio credit utilization. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
run_started_at. Defaults to the time of the request.run_started_at. Omitted ⇒ the 2025-01-08 floor — no credit data exists before then, and there is no limit on how far back you can query. A value earlier than 2025-01-08 is treated as 2025-01-08 (not rejected), matching the audit log.Output
Get AI Studio seats
Get AI Studio seats
ASANA_GET_AI_STUDIO_SEATSGet AI Studio seats. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get Allocation
Get Allocation
ASANA_GET_ALLOCATIONGet an allocation by ID. Use when you need to retrieve the details of a specific allocation.Input Parameters
Output
Get Allocations
Get Allocations
ASANA_GET_ALLOCATIONSTool to get multiple allocations. Requires either ‘parent’ (project GID) OR both ‘assignee’ AND ‘workspace’ together.Input Parameters
Output
Get a project
Get a project
ASANA_GET_A_PROJECTRetrieves 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.Input Parameters
Output
Get a task
Get a task
ASANA_GET_A_TASKRetrieves full details for a specified task GID accessible by the user; use opt_fields to customize returned data.Input Parameters
Output
Get Attachment
Get Attachment
Get Audit Log Events
Get Audit Log Events
ASANA_GET_AUDIT_LOG_EVENTSRetrieve audit log events for a workspace or organization, with optional filters. Asana requires a service account for audit log access.Input Parameters
Output
Get a user task list
Get a user task list
ASANA_GET_A_USER_TASK_LISTRetrieves a user’s Asana task list for a specified workspace, using the user GID or me in user_task_list_gid. Optionally requests fields such as name, owner, and workspace using opt_fields.Input Parameters
["owner", "workspace"] as the value for this field.Output
Get a budget
Get a budget
ASANA_GET_BUDGETGet a budget.Input Parameters
Output
Get all budgets
Get all budgets
ASANA_GET_BUDGETSGet all budgets.Input Parameters
project.Output
Get current user
Get current user
Get Custom Field
Get Custom Field
ASANA_GET_CUSTOM_FIELDRetrieve a custom field by its globally unique identifier, with optional selection of returned properties.Input Parameters
Output
Get a goal's custom fields
Get a goal's custom fields
ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_GOALGet a goal’s custom fields. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.Input Parameters
Output
Get a portfolio's custom fields
Get a portfolio's custom fields
ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_PORTFOLIOGet a portfolio’s custom fields. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.Input Parameters
Output
Get a team's custom fields
Get a team's custom fields
ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_TEAMGet a team’s custom fields.Input Parameters
Output
Get Custom Fields for Workspace
Get Custom Fields for Workspace
ASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACEList custom fields in a workspace, returning a page of results and pagination information when available.Input Parameters
Output
Get a custom type
Get a custom type
ASANA_GET_CUSTOM_TYPEGet a custom type.Input Parameters
Output
Get Custom Types
Get Custom Types
ASANA_GET_CUSTOM_TYPESList custom types associated with a project, returning a page of results and pagination information when available.Input Parameters
Output
Get Events on a Resource
Get Events on a Resource
ASANA_GET_EVENTSRetrieve events on an Asana resource to monitor changes using a sync token. A 412 response is returned as an empty event list with a new sync token for subsequent calls.Input Parameters
Output
Get Favorites for User
Get Favorites for User
ASANA_GET_FAVORITES_FOR_USERGet a user’s favorites of a selected resource type within a workspace, ordered as they appear in the Asana sidebar. The resource type defaults to projects.Input Parameters
Output
Get Goal
Get Goal
Get a goal relationship
Get a goal relationship
ASANA_GET_GOAL_RELATIONSHIPGet a goal relationship. Requires an Asana subscription with Goals access.Input Parameters
Output
Get Goal Relationships
Get Goal Relationships
Get Goals
Get Goals
ASANA_GET_GOALSTool 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.Input Parameters
Output
Get Job
Get Job
ASANA_GET_JOBTool 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.Input Parameters
Output
Get Membership
Get Membership
ASANA_GET_MEMBERSHIPTool 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.Input Parameters
Output
Get Memberships
Get Memberships
ASANA_GET_MEMBERSHIPSTool 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.Input Parameters
Output
Get multiple projects
Get multiple projects
ASANA_GET_MULTIPLE_PROJECTSReturns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.Input Parameters
next_page.offset field. IMPORTANT: Use the COMPLETE token exactly as returned - tokens are long strings (~150-200 characters) with three base64 sections separated by dots (header.payload.signature). Do NOT truncate or modify the token.OptFieldsEnm0 for available fields.Output
Get multiple tasks
Get multiple tasks
ASANA_GET_MULTIPLE_TASKSRetrieve tasks using exactly one scope: a project, section, tag, user task list, or assignee and workspace together. Supports completed-since and modified-since filters and pagination.Input Parameters
workspace. When using assignee+workspace, always set a limit (defaults to 50 if omitted).assignee. Mutually exclusive with project, section, tag, or user_task_list.Output
Get multiple users
Get multiple users
ASANA_GET_MULTIPLE_USERSReturns 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.Input Parameters
Output
Get multiple workspaces
Get multiple workspaces
ASANA_GET_MULTIPLE_WORKSPACESRetrieve workspaces accessible to the authenticated user, with pagination support.Input Parameters
Output
Get OOO Entries
Get OOO Entries
ASANA_GET_OOO_ENTRIESGet one page of out-of-office entries for a user in a workspace. Use optional date filters to find overlapping entries. To continue, pass the returned next_page.offset with the same user, workspace, and filters.Input Parameters
Output
Get an OOO entry
Get an OOO entry
ASANA_GET_OOO_ENTRYGet an OOO entry.Input Parameters
Output
Get parent goals from a goal
Get parent goals from a goal
ASANA_GET_PARENT_GOALS_FOR_GOALGet parent goals from a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Get Portfolio
Get Portfolio
Get Portfolio Items
Get Portfolio Items
ASANA_GET_PORTFOLIO_ITEMSRetrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.Input Parameters
Output
Get a portfolio membership
Get a portfolio membership
ASANA_GET_PORTFOLIO_MEMBERSHIPGet a portfolio membership. Requires an Asana plan with Portfolios access.Input Parameters
Output
Get Portfolio Memberships
Get Portfolio Memberships
ASANA_GET_PORTFOLIO_MEMBERSHIPSTool 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.Input Parameters
Output
Get memberships from a portfolio
Get memberships from a portfolio
ASANA_GET_PORTFOLIO_MEMBERSHIPS_FOR_PORTFOLIOGet memberships from a portfolio. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.Input Parameters
Output
Get Portfolios
Get Portfolios
ASANA_GET_PORTFOLIOSRetrieve portfolios in a specific workspace for a specified owner.Input Parameters
Output
Get Project Brief
Get Project Brief
ASANA_GET_PROJECT_BRIEFTool 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.Input Parameters
Output
Get Project Custom Field Settings
Get Project Custom Field Settings
Get Project Membership
Get Project Membership
ASANA_GET_PROJECT_MEMBERSHIPTool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.Input Parameters
Output
Get Project Memberships For Project
Get Project Memberships For Project
ASANA_GET_PROJECT_MEMBERSHIPSTool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.Input Parameters
Output
Get a project portfolio setting
Get a project portfolio setting
ASANA_GET_PROJECT_PORTFOLIO_SETTINGGet a project portfolio setting.Input Parameters
Output
Get project portfolio settings for a portfolio
Get project portfolio settings for a portfolio
ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PORTFOLIOGet project portfolio settings for a portfolio. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.Input Parameters
Output
Get project portfolio settings for a project
Get project portfolio settings for a project
ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PROJECTGet project portfolio settings for a project. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get Projects for Task
Get Projects for Task
ASANA_GET_PROJECTS_FOR_TASKList projects associated with a specific task. Results are paginated, with a next-page token when available.Input Parameters
Output
Get Projects for Team
Get Projects for Team
ASANA_GET_PROJECTS_FOR_TEAMTool to get a list of projects for a specific team in Asana. Use when you need to retrieve project details associated with a team.Input Parameters
Output
Get Project Status
Get Project Status
Get Project Status Updates
Get Project Status Updates
ASANA_GET_PROJECT_STATUS_UPDATESTool 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.Input Parameters
Output
Get Project Template
Get Project Template
Get Multiple Project Templates
Get Multiple Project Templates
ASANA_GET_PROJECT_TEMPLATESTool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.Input Parameters
Output
Get Project Templates for Team
Get Project Templates for Team
ASANA_GET_PROJECT_TEMPLATES_FOR_TEAMTool to get a team’s project templates in Asana. Use when you need to retrieve project templates associated with a specific team.Input Parameters
Output
Get a rate
Get a rate
ASANA_GET_RATEGet a rate.Input Parameters
Output
Get multiple rates
Get multiple rates
ASANA_GET_RATESGet multiple rates. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get Reactions on Object
Get Reactions on Object
ASANA_GET_REACTIONS_ON_OBJECTTool 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.Input Parameters
Output
Get a role
Get a role
ASANA_GET_ROLEGet a role.Input Parameters
Output
Get multiple roles
Get multiple roles
ASANA_GET_ROLESGet multiple roles. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get Section
Get Section
ASANA_GET_SECTIONRetrieve 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.Input Parameters
Output
Get sections in a project
Get sections in a project
Get Status Update
Get Status Update
ASANA_GET_STATUSTool 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.Input Parameters
Output
Get Status Updates
Get Status Updates
ASANA_GET_STATUS_UPDATESRetrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.Input Parameters
next_page property. This is used for pagination.Output
Get stories from a goal
Get stories from a goal
ASANA_GET_STORIES_FOR_GOALGet stories from a goal. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.Input Parameters
resource_subtype=comment_added to get just the comments added since a given moment. The bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the created_at of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on gid.true (the default) is oldest first, false is newest first. Pair false with limit to read only the most recent stories. Ordering is applied across the parent’s stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair false with created_after to bound what is considered.comment_added is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed.Output
Get Stories for Task
Get Stories for Task
Get Story
Get Story
Get Tag
Get Tag
Get Task Attachments
Get Task Attachments
ASANA_GET_TASK_ATTACHMENTSTool 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.Input Parameters
created_at, download_url, host, name, parent, parent.name, permanent_url, resource_subtype, size, view_url.Output
Get Task Counts For Project
Get Task Counts For Project
ASANA_GET_TASK_COUNTS_FOR_PROJECTTool 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.Input Parameters
Output
Get a task for a given custom ID
Get a task for a given custom ID
Get tasks for tag
Get tasks for tag
ASANA_GET_TASKS_FOR_TAGTool 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.Input Parameters
Output
Get tasks for user task list
Get tasks for user task list
ASANA_GET_TASKS_FOR_USER_TASK_LISTTool 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.Input Parameters
Output
Retrieve tasks for project
Retrieve tasks for project
ASANA_GET_TASKS_FROM_A_PROJECTRetrieves tasks from a specified Asana project, with a completion-since filter and optional field selection. Returned task details are limited to the tool’s response fields.Input Parameters
Output
Get tasks from a section
Get tasks from a section
ASANA_GET_TASKS_FROM_SECTIONTool 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.Input Parameters
Output
Get Task Subtasks
Get Task Subtasks
ASANA_GET_TASK_SUBTASKSLists subtasks of a specified Asana task, with pagination and optional field selection.Input Parameters
Output
Get a task template
Get a task template
ASANA_GET_TASK_TEMPLATERetrieve a task template’s configuration by its GID, without instantiating it. Discover template GIDs by listing task templates for a project first.Input Parameters
Output
Get Task Templates
Get Task Templates
Get Team
Get Team
ASANA_GET_TEAMTool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.Input Parameters
Output
Get Team Membership
Get Team Membership
ASANA_GET_TEAM_MEMBERSHIPTool to retrieve a complete team membership record by its GID. Use when you need to fetch details about a specific team membership in Asana.Input Parameters
Output
Get Team Memberships
Get Team Memberships
Get Team Memberships for Team
Get Team Memberships for Team
ASANA_GET_TEAM_MEMBERSHIPS_FOR_TEAMTool 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.Input Parameters
Output
Get Team Memberships For User
Get Team Memberships For User
ASANA_GET_TEAM_MEMBERSHIPS_FOR_USERRetrieve a page of team memberships for a specific user within a workspace. Pagination information can be used to retrieve further results.Input Parameters
Output
Get Teams for User
Get Teams for User
ASANA_GET_TEAMS_FOR_USERGet a page of team records for a specific user in an organization or workspace. Pagination information can be used to retrieve further results.Input Parameters
Output
Get teams in workspace
Get teams in workspace
ASANA_GET_TEAMS_IN_WORKSPACERetrieve a page of compact team records in a workspace visible to the authorized user.Input Parameters
Output
Get Time Period
Get Time Period
ASANA_GET_TIME_PERIODTool 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.Input Parameters
Output
Get Time Periods
Get Time Periods
Get a timesheet approval status
Get a timesheet approval status
ASANA_GET_TIMESHEET_APPROVAL_STATUSGet a timesheet approval status.Input Parameters
Output
Get multiple timesheet approval statuses
Get multiple timesheet approval statuses
ASANA_GET_TIMESHEET_APPROVAL_STATUSESGet multiple timesheet approval statuses. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get time tracking categories for a workspace
Get time tracking categories for a workspace
ASANA_GET_TIME_TRACKING_CATEGORIESGet time tracking categories for a workspace. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get a time tracking category
Get a time tracking category
ASANA_GET_TIME_TRACKING_CATEGORYGet a time tracking category.Input Parameters
Output
Get Time Tracking Entries
Get Time Tracking Entries
ASANA_GET_TIME_TRACKING_ENTRIESTool 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.Input Parameters
Output
Get Time Tracking Entries for Task
Get Time Tracking Entries for Task
ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TASKTool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.Input Parameters
Output
Get time tracking entries for a time tracking category
Get time tracking entries for a time tracking category
ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TIME_TRACKING_CATEGORYGet time tracking entries for a time tracking category. Returns one page; pass next_page.offset with the same filters to continue.Input Parameters
Output
Get a time tracking entry
Get a time tracking entry
ASANA_GET_TIME_TRACKING_ENTRYGet a time tracking entry.Input Parameters
Output
Get Objects via Typeahead
Get Objects via Typeahead
ASANA_GET_TYPEAHEAD_OBJECTSTool 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.Input Parameters
Output
Get User
Get User
ASANA_GET_USERGet a user by their ID.Input Parameters
Output
Get User in Workspace
Get User in Workspace
ASANA_GET_USER_FOR_WORKSPACETool 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.Input Parameters
Output
Get Users for Team
Get Users for Team
Get Users in Workspace
Get Users in Workspace
ASANA_GET_USERS_FOR_WORKSPACEGet users in a workspace or organization.Input Parameters
Output
Get User Task List
Get User Task List
ASANA_GET_USER_TASK_LISTTool 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.Input Parameters
Output
Get a webhook
Get a webhook
ASANA_GET_WEBHOOKGet a webhook.Input Parameters
Output
Get Webhooks
Get Webhooks
ASANA_GET_WEBHOOKSRetrieve a page of webhooks in a workspace, optionally filtered by resource. Use the returned pagination information to retrieve additional pages.Input Parameters
Output
Get Workspace
Get Workspace
ASANA_GET_WORKSPACETool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.Input Parameters
Output
Get workspace events
Get workspace events
ASANA_GET_WORKSPACE_EVENTSGet one page of workspace events since a sync token was created. Omit sync initially. A missing or expired token returns a fresh sync token as a successful continuation response. Call again with that token to read events. Each page is limited to 1000 events; while has_more is true, call again with the returned sync token. Requires a service account with Workspace Events access in an Enterprise+ domain or an Enterprise domain with the Compliance Management Add-on.Input Parameters
412 Precondition Failed error, and include a fresh sync token in the response.Output
Get Workspace Membership
Get Workspace Membership
ASANA_GET_WORKSPACE_MEMBERSHIPTool to retrieve a specific workspace membership by its GID. Use when you need to get details about a user’s membership in a workspace.Input Parameters
Output
Get Workspace Memberships
Get Workspace Memberships
ASANA_GET_WORKSPACE_MEMBERSHIPSTool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.Input Parameters
Output
Get Workspace Memberships For User
Get Workspace Memberships For User
ASANA_GET_WORKSPACE_MEMBERSHIPS_FOR_USERRetrieve a page of workspace memberships for a specific user. Use the returned pagination information to retrieve additional pages.Input Parameters
Output
Get Workspace Projects
Get Workspace Projects
ASANA_GET_WORKSPACE_PROJECTSRetrieve a page of projects associated with a specific Asana workspace. Use the returned pagination information to retrieve additional pages.Input Parameters
Output
Reorder Enum Option for Custom Field
Reorder Enum Option for Custom Field
ASANA_INSERT_ENUM_OPTION_FOR_CUSTOM_FIELDTool 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.Input Parameters
Output
Move or Insert Section in Project
Move or Insert Section in Project
ASANA_INSERT_SECTION_FOR_PROJECTTool 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.Input Parameters
Output
Instantiate Project Template
Instantiate Project Template
ASANA_INSTANTIATE_PROJECT_TEMPLATEInstantiate (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.Input Parameters
Output
Instantiate a task from a task template
Instantiate a task from a task template
ASANA_INSTANTIATE_TASK_TEMPLATEInstantiate a task from a task template.Input Parameters
Output
Get goal relationships
Get goal relationships
ASANA_LIST_GOAL_RELATIONSHIPSGet goal relationships. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.Input Parameters
Output
List Task Dependencies
List Task Dependencies
List Task Dependents
List Task Dependents
Reject access request
Reject access request
Remove a custom field from a goal
Remove a custom field from a goal
ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_GOALRemove a custom field from a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Remove a custom field from a portfolio
Remove a custom field from a portfolio
ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PORTFOLIORemove a custom field from a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Remove a custom field from a project
Remove a custom field from a project
ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PROJECTRemove a custom field from a project.Input Parameters
Output
Remove Follower From Task
Remove Follower From Task
Remove Followers For Project
Remove Followers For Project
ASANA_REMOVE_FOLLOWERS_FOR_PROJECTTool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.Input Parameters
Output
Remove a collaborator from a goal
Remove a collaborator from a goal
ASANA_REMOVE_FOLLOWERS_FROM_GOALRemove a collaborator from a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Remove Item from Portfolio
Remove Item from Portfolio
ASANA_REMOVE_ITEM_FROM_PORTFOLIOTool 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.Input Parameters
Output
Remove users from a portfolio
Remove users from a portfolio
ASANA_REMOVE_MEMBERS_FOR_PORTFOLIORemove users from a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Remove Members from Project
Remove Members from Project
ASANA_REMOVE_MEMBERS_FOR_PROJECTTool 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.Input Parameters
Output
Remove Project from Task
Remove Project from Task
ASANA_REMOVE_PROJECT_FROM_TASKTool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.Input Parameters
Output
Removes a supporting goal relationship
Removes a supporting goal relationship
ASANA_REMOVE_SUPPORTING_RELATIONSHIPRemoves a supporting goal relationship. Requires an Asana subscription with Goals access.Input Parameters
Output
Remove Tag from Task
Remove Tag from Task
ASANA_REMOVE_TAG_FROM_TASKTool 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.Input Parameters
Output
Remove Task Dependencies
Remove Task Dependencies
ASANA_REMOVE_TASK_DEPENDENCIESTool to unlink selected prerequisite relationships from an Asana task without deleting any task.Input Parameters
Output
Remove Task Dependents
Remove Task Dependents
Remove User For Team
Remove User For Team
ASANA_REMOVE_USER_FOR_TEAMTool to remove a user from a team. Use when you need to revoke team membership for a specific user.Input Parameters
Output
Remove User from Workspace
Remove User from Workspace
ASANA_REMOVE_USER_FOR_WORKSPACETool to remove a user from a workspace or organization. Use when you need to revoke a user’s access to a specific workspace.Input Parameters
Output
Roll up subtask dates for a project
Roll up subtask dates for a project
ASANA_ROLLUP_PROJECTStart a background job to reconcile subtask dates in a project. Poll Get Job with the returned job gid to check completion.Input Parameters
Output
Roll up subtask dates for a task
Roll up subtask dates for a task
ASANA_ROLLUP_TASKStart a background job to reconcile a task’s subtask dates. Poll Get Job with the returned job gid to check completion.Input Parameters
Output
Create a project template from a project
Create a project template from a project
ASANA_SAVE_PROJECT_AS_TEMPLATECreate a project template from a project.Input Parameters
Output
Search projects in a workspace
Search projects in a workspace
ASANA_SEARCH_PROJECTS_FOR_WORKSPACESearch projects in a workspace.Input Parameters
next_page, so to retrieve further results, sort by created_at and repeat the query with a created_at.before or created_at.after filter that excludes the results you have already seen.due_date, created_at, completed_at, relevance, or modified_at, defaults to modified_at.Output
Search Tasks in Workspace
Search Tasks in Workspace
ASANA_SEARCH_TASKS_IN_WORKSPACESearch tasks in an Asana workspace by project, assignee, task subtype or text, with optional result fields and a limit of 1–100. When the plan does not provide workspace search, filtering is reduced: text and combined project and assignee filters are not fully applied.Input Parameters
Output
Set parent for task
Set parent for task
ASANA_SET_PARENT_FOR_TASKTool 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.Input Parameters
Output
Submit Parallel Requests (Batch API)
Submit Parallel Requests (Batch API)
Trigger a rule
Trigger a rule
Update Allocation
Update Allocation
Update a task
Update a task
ASANA_UPDATE_A_TASKUpdates attributes of an existing Asana task identified by its task_gid.Input Parameters
Output
Update a budget
Update a budget
ASANA_UPDATE_BUDGETUpdate a budget.Input Parameters
Output
Update Custom Field
Update Custom Field
ASANA_UPDATE_CUSTOM_FIELDUpdate the name or description of a custom field by its globally unique identifier.Input Parameters
Output
Update Enum Option
Update Enum Option
ASANA_UPDATE_ENUM_OPTIONTool 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.Input Parameters
Output
Update a goal
Update a goal
ASANA_UPDATE_GOALUpdate a goal. Requires an Asana subscription with Goals access.Input Parameters
Output
Update a goal metric
Update a goal metric
ASANA_UPDATE_GOAL_METRICUpdate a goal metric. Requires an Asana subscription with Goals access.Input Parameters
Output
Update a goal relationship
Update a goal relationship
ASANA_UPDATE_GOAL_RELATIONSHIPUpdate a goal relationship. Requires an Asana subscription with Goals access.Input Parameters
Output
Update a membership
Update a membership
ASANA_UPDATE_MEMBERSHIPUpdate a membership.Input Parameters
Output
Update an OOO entry
Update an OOO entry
ASANA_UPDATE_OOO_ENTRYUpdate an OOO entry.Input Parameters
Output
Update a portfolio
Update a portfolio
ASANA_UPDATE_PORTFOLIOUpdate a portfolio. Requires an Asana plan with Portfolios access.Input Parameters
Output
Update a project
Update a project
ASANA_UPDATE_PROJECTUpdate a project.Input Parameters
Output
Update Project Brief
Update Project Brief
ASANA_UPDATE_PROJECT_BRIEFTool 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.Input Parameters
Output
Update a project portfolio setting
Update a project portfolio setting
ASANA_UPDATE_PROJECT_PORTFOLIO_SETTINGUpdate a project portfolio setting.Input Parameters
Output
Update a rate
Update a rate
ASANA_UPDATE_RATEUpdate a rate.Input Parameters
Output
Update a role
Update a role
ASANA_UPDATE_ROLEUpdate a role.Input Parameters
Output
Update Section
Update Section
ASANA_UPDATE_SECTIONUpdate 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.Input Parameters
Output
Update Story
Update Story
ASANA_UPDATE_STORYTool 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.Input Parameters
Output
Update Tag
Update Tag
Update a team
Update a team
Update a timesheet approval status
Update a timesheet approval status
ASANA_UPDATE_TIMESHEET_APPROVAL_STATUSUpdate a timesheet approval status.Input Parameters
Output
Update a time tracking category
Update a time tracking category
ASANA_UPDATE_TIME_TRACKING_CATEGORYUpdate a time tracking category.Input Parameters
Output
Update a time tracking entry
Update a time tracking entry
ASANA_UPDATE_TIME_TRACKING_ENTRYUpdate a time tracking entry.Input Parameters
Output
Update User
Update User
ASANA_UPDATE_USERUpdate 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.Input Parameters
Output
Update User for Workspace
Update User for Workspace
ASANA_UPDATE_USER_FOR_WORKSPACETool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.Input Parameters
Output
Update a webhook
Update a webhook
ASANA_UPDATE_WEBHOOKUpdate an existing Asana webhook’s event filter configuration. At least one non-empty filter is required.Input Parameters
Output
Update a workspace
Update a workspace
ASANA_UPDATE_WORKSPACEUpdate a workspace.Input Parameters
Output
Triggers
Attachment Added to Task
Attachment Added to Task
ASANA_TASK_ATTACHMENT_ADDEDType: webhookTriggers when an attachment is added to a task.Configuration
Payload
New Comment on Task
New Comment on Task
ASANA_TASK_COMMENT_ADDEDType: webhookTriggers when a comment is added to a task in a project.Configuration
Payload
New Task Created
New Task Created
ASANA_TASK_CREATEDType: webhookTriggers when a new task is created in a project.Configuration
Payload
Task Moved to Section
Task Moved to Section
ASANA_TASK_MOVED_TO_SECTIONType: webhookTriggers when a task is moved to a section in a project.Configuration
Payload
Tag Added to Task
Tag Added to Task
ASANA_TASK_TAG_ADDEDType: webhookTriggers when a tag is added to a task.Note: Asana’s event structure is inverted for tag events — the resource is the task and the parent is the tag. So parent.gid gives the tag GID.Configuration
Payload
Task Updated
Task Updated
ASANA_TASK_UPDATEDType: webhookTriggers when a task is updated in a project.