Tool to help teams organize, track, and manage their work.
Tool to help teams organize, track, and manage their work. On Nagent, Asana is exposed as a fully-configurable project management integration that any agent can call — 153 actions, 6 triggers, and OAuth authentication. No code is required to wire Asana into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Asana to automate the kinds of tasks project management teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Asana also supports 4 event triggers ("Attachment Added to Task", "New Comment on Task", "New Task Created", and more), which lets your Nagent agents react to Asana activity in real time — for example, kicking off a downstream workflow the moment a relevant event fires.
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Asana into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Triggers are the entry points of agents built on Nagent — pick one to fire your agent the moment a Asana event happens. Webhook triggers run instantly; poll triggers check on an interval you configure. Each shows its configuration parameters and the payload your agent receives.
ASANA_TASK_ATTACHMENT_ADDEDTriggers when an attachment is added to a task.
Configuration
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Payload
GID of the attachment
Subtype of the attachment (e.g. 'external')
Timestamp of the event
GID of the task the attachment was added to
GID of the user who added the attachment
ASANA_TASK_COMMENT_ADDEDTriggers when a comment is added to a task in a project.
Configuration
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Payload
Timestamp of the event
GID of the comment story
GID of the task the comment was added to
GID of the user who posted the comment
ASANA_TASK_CREATEDTriggers when a new task is created in a project.
Configuration
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Payload
Timestamp of the event
GID of the project the task was added to
GID of the created task
GID of the user who created the task
ASANA_TASK_MOVED_TO_SECTIONTriggers when a task is moved to a section in a project.
Configuration
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Asana GID of the destination section (numeric string, e.g. '1214062125915600'). Find it via GET /projects/{project_gid}/sections or from the Asana UI section URL. Must be a GID — section names are not accepted. Only triggers when a task is moved to this specific section. If empty, triggers for any section move.
Payload
Timestamp of the event
GID of the destination section
GID of the task that was moved
GID of the user who moved the task
ASANA_TASK_TAG_ADDEDTriggers 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
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Asana GID of the tag (numeric string, e.g. '1214062370176213'). Find it via GET /workspaces/{workspace_gid}/tags. Must be a GID — tag names (e.g. 'urgent') are not accepted. Only triggers when this specific tag is added. If empty, triggers for any tag.
Payload
Timestamp of the event
GID of the tag that was added
GID of the task the tag was added to
GID of the user who added the tag
ASANA_TASK_UPDATEDTriggers when a task is updated in a project.
Configuration
Only trigger when one of these fields changes (e.g. \['assignee', 'due_on', 'name'\]). If not set, triggers on any field change.
Asana GID of the project to monitor (numeric string, e.g. '1213430481840948'). Find it via the Asana REST API (GET /workspaces/{workspace_gid}/projects) or from the Asana project URL (https://app.asana.com/0/{project_gid}/...). Must be a GID — project names are not accepted.
Payload
The change action (e.g. 'changed')
Name of the field that changed
Timestamp of the event
New value of the field, if available
GID of the updated task
GID of the user who made the change
Every operation an agent can call against Asana, with input parameters and output schema. Drop these into any step of an agent built in Helix.
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
A string identifying users. These can either be the string "me", an email, or the gid of a user. For multiple followers, use a comma-separated string.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier for the task.
An array of user GIDs to add as followers to the task. For example: \["12345", "67890"\].
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. For example \["followers", "assignee"\].
Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier (GID) of the item to add to the portfolio. Typically a project GID, but can be any supported portfolio item type. Must be a numeric string.
GID of a portfolio item after which to insert the new item. Mutually exclusive with `insert_before`.
GID of a portfolio item before which to insert the new item. Mutually exclusive with `insert_after`.
The globally unique identifier (GID) of the portfolio to add the item to. Must be a numeric string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
An array of strings identifying users. These can either be the string "me", an email, or the gid of a user. For example: "521621,621373" or "me,user@example.com".
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. For example: \["members", "name", "archived"\].
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier for the project to add to the task.
A section in the project to insert the task into. The task will be inserted at the bottom of the section unless combined with `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.
The globally unique identifier for the task to add a project to.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
A task in the project to insert the task after, or `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.
A task in the project to insert the task before, or `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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The request data for adding a supporting relationship.
Globally unique identifier for the goal.
This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier for the tag to add. The tag must already exist in the workspace.
The globally unique identifier for the task.
Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
Provides 'pretty' output. Provides the response in a 'pretty' format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier for the task that will depend on other tasks.
Comma-separated list of fields to include in the response. By default, the response returns a compact representation of the task. Use this to retrieve additional fields such as 'name', 'assignee', 'due_on', 'dependencies', etc.
Provides 'pretty' output. Provides the response in a 'pretty' format with proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
An array of task GIDs that the target task depends on (i.e., these tasks must be completed before the target task can be started). Each GID should be a valid task identifier.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The GID of the existing task to add to the section. Must be a numeric string.
The GID of the target section. Must be a section GID (not a project or task GID). Use GET_SECTIONS_IN_PROJECT to retrieve valid section GIDs from a project.
GID of a task in the section after which to insert the current task. Mutually exclusive with insert_before.
GID of a task in the section before which to insert the current task. Mutually exclusive with insert_after.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Globally unique identifier for the team.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Comma-separated list of fields to include in the response.
Provides "pretty" output. Provides the response in a "pretty" format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the access request to approve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier (gid) of the access requestable object that the user is requesting access to. Supports projects and portfolios.
The optional message to include with the access request. This can be used to provide context or additional information about the request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_ALLOCATIONCreates 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.
Input parameters
Any additional notes related to the allocation.
The end date of the allocation. The format is YYYY-MM-DD.
The start date of the allocation. The format is YYYY-MM-DD.
The unit type for tracking effort on the allocation. Must be either 'hours' or 'percent'.
The project GID for which this allocation is being made. If provided, the allocation will be linked to this project.
The ID of the user to whom the allocation is assigned. This can be the user's GID or the string 'me' to refer to the authenticated user.
The numeric effort value for the allocation. Represents hours per week if effort_type is 'hours', or percentage if effort_type is 'percent'.
The ID of the workspace where the allocation will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_A_PROJECTCreates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.
Input parameters
Data payload for the new project.
Array of optional properties to include in the response.
True for human-readable JSON response (debugging only due to size/processing).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The properties for the tag creation, including name (required), color (optional), and notes (optional).
Comma-separated string of fields from `OptFieldsEnm0` (e.g., 'name', 'color') to include in the response; returns a compact representation by default.
If true, pretty-prints the JSON response; useful for debugging but may increase response size.
The globally unique identifier (GID) for the workspace or organization in which to create the tag.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Task details for creation.
List of optional field names to include in the response. Common fields include: name, assignee, due_on, completed, projects, memberships, memberships.section, memberships.section.name, etc. For section information, use memberships.section or memberships.section.name. Default is compact resource.
Provides 'pretty' JSON output with line breaks/indentation. Useful for debugging; may increase response time/size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The URL of the external resource being attached. Required for attachments of type 'external'. Mutually exclusive with 'file'.
Required for 'asana' attachments. This field should be provided when uploading a file. Mutually exclusive with 'url'.
The name of the external resource being attached. Required for attachments of type 'external'. For file uploads, this is optional and will be derived from the file if not provided.
Required identifier of the parent task, project, or project_brief, as a string. This is the GID of the object to attach the file or URL to.
Optional. Only relevant for external attachments with a parent task. A boolean indicating whether the current app should be connected with the attachment for the purposes of showing an app components widget. Requires the app to have been added to a project the parent task is in. This property can only be set if an OAuth token is used to authenticate the request.
The type of the attachment. Must be 'asana' for file uploads or 'external' for URL attachments. If not specified, a file attachment of type 'asana' will be assumed. Note that if the value is 'external', 'name' and 'url' must also be provided.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The file to upload.
Globally unique identifier for the parent task or comment.
Whether to connect the attachment to the app. If true, the attachment will be displayed in the Asana UI as an app attachment. If false, the attachment will be displayed as a regular file attachment. Defaults to true.
The type of the attachment. Must be one of the given values. If not specified, a regular file attachment will be created. If 'asana' is specified, the attachment will be a link to another Asana task. If 'external' is specified, the attachment will be a link to an external resource. If 'gdrive' is specified, the attachment will be a link to a Google Drive file. If 'box' is specified, the attachment will be a link to a Box file. If 'dropbox' is specified, the attachment will be a link to a Dropbox file. If 'vimeo' is specified, the attachment will be a link to a Vimeo video.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_CUSTOM_FIELDTool 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.
Input parameters
The custom field object to create.
Comma-separated list of properties to include in the response.
Provides “pretty” output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_ENUM_OPTION_FOR_CUSTOM_FIELDTool to create a new enum option for a custom field in Asana. Use this when you need to add a new selectable option to an existing custom field.
Input parameters
The enum option to create.
Defines fields to return.
Provides “pretty” output.
Globally unique identifier for the custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Role of the member in the parent resource. This is an optional parameter.
GID of the member (user or team) to add to the parent resource. Must be a numeric GID string (e.g., '1210124065021206').
GID of the parent resource (project, goal, or portfolio) to add the member to. Must be a numeric GID string (e.g., '1210474562469922').
Provides 'pretty' output with proper line breaking and indentation for debugging. May increase response size.
Access level for the member in the parent resource. Common values: 'admin', 'editor', 'commenter', 'viewer'. Defaults to 'editor' if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Rich text content wrapped in HTML body tag. The content must be wrapped in a <body> tag, e.g., '<body>Project brief content here</body>'.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Available options: html_text, permalink_url, project, project.name, text, title
Provides 'pretty' output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Project data payload containing the project details to create.
Globally unique identifier for the team. This is the team where the project will be created.
Array of optional field names to include in the response (e.g., 'name', 'notes', 'owner', 'workspace.name'). By default, some properties are excluded.
Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Project data payload containing the project details to create.
Array of optional field names to include in the response (e.g., 'name', 'notes', 'owner', 'team.name', 'workspace.name'). By default, some properties are excluded.
Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.
Globally unique identifier for the workspace or organization where the project will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The HTML content of the status update.
Color of the status update. Supported values: GREEN, YELLOW, RED, BLUE, COMPLETE.
The title of the project status update.
Globally unique identifier for the project.
The type of status. Must be one of: on_track, at_risk, off_track, on_hold, complete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Name for the new section. This is a section name (e.g., 'To Do', 'In Progress'), NOT a task name.
GID of the project where the section will be created. Must be a valid project GID.
GID of an existing section to insert the new section after; if omitted (and `insert_before` is also omitted), the new section is added at the end.
GID of an existing section to insert the new section before; if omitted, the new section is added at the end.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The text content of the status update. This is the body of the status update that will be sent to all followers of the parent object.
The title of the status update. If not provided, Asana may auto-generate a title based on the status_type.
Globally unique identifier (GID) of the object to create a status update on. Can be a project, portfolio, or goal GID. GIDs are long numeric strings (e.g., '1210124791807961').
List of optional field names to include in the response. Common fields include: gid, title, text, status_type, created_at, created_by, author, parent, resource_subtype, html_text, etc.
Provides 'pretty' JSON output with line breaks and indentation. Useful for debugging; may increase response time and size.
The type of status update. Must be one of: on_track (project is on track), at_risk (project is at risk), off_track (project is off track), on_hold (project is on hold), complete (project is complete).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The name of the subtask to be created.
Optional descriptive text for the subtask.
Optional due date and time for the subtask in ISO 8601 format (e.g., YYYY-MM-DDTHH:mm:ssZ), which is more specific than `due_on`.
Optional due date for the subtask in YYYY-MM-DD format, representing the end of the day for the task.
User to assign to this subtask. Accepts either a numeric user GID (e.g., '1234567890123456') or the special value 'me' for the authenticated user. If not provided, the subtask will be unassigned.
The numeric Global ID (GID) of the parent task under which the subtask will be created. Must be a numeric string (digits only). Special values like 'me' are not accepted.
Optional flag to mark the subtask as completed upon creation. Defaults to false if not specified.
Optional array of user Global IDs (GIDs) to add as followers to the subtask. Followers receive notifications about subtask updates.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The properties for the tag to be created.
List of field names to include in the response. Common fields: color, created_at, followers, name, notes, permalink_url, workspace.
If true, provides pretty-printed JSON response. Useful for debugging but may increase response size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_TASK_COMMENTAdds a new text comment (story) to an existing Asana task, appearing in its activity feed.
Input parameters
The plain text content of the comment to be posted on the task. HTML or rich text is not supported via this field.
The globally unique identifier (GID) of the Asana task to which the comment will be added.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_CREATE_TEAMTool to create a new team in an Asana workspace. Use when you need to establish a new team for collaboration.
Input parameters
The request data for creating a team.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the allocation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_ATTACHMENTTool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.
Input parameters
Provides “pretty” output.
Globally unique identifier for the attachment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_CUSTOM_FIELDTool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.
Input parameters
Globally unique identifier for the custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the membership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_PROJECTDelete a project.
Input parameters
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project brief to delete. Must be a numeric string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project status to delete. Must be a numeric string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_SECTIONTool to delete a section by its GID. Use when you need to permanently remove a section from a project.
Input parameters
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
The globally unique identifier for the section to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the status update to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_STORYTool to delete a story by its GID. Use when you need to remove a story from Asana.
Input parameters
Globally unique identifier for the story.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_TAGTool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.
Input parameters
The globally unique identifier for the tag.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DELETE_TASKDelete a task.
Input parameters
Globally unique identifier for the task to delete. Must be a numeric string.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DUPLICATE_PROJECTDuplicate a project.
Input parameters
The name of the new project.
Globally unique identifier for the team that the new project will belong to.
A list of elements to be included in the duplication.
Globally unique identifier for the project to be duplicated.
Scheduling information for the new project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_DUPLICATE_TASKDuplicate a task
Input parameters
The name of the new task.
A comma-separated string of properties to copy from the original task.
The globally unique identifier for the task to be duplicated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Globally unique identifier for the target object.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_ALLOCATIONGet an allocation by ID. Use when you need to retrieve the details of a specific allocation.
Input parameters
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the allocation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_ALLOCATIONSTool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.
Input parameters
Results per page.
Offset token.
Globally unique identifier for the project to filter allocations by. Required if 'assignee' and 'workspace' are not both provided.
Globally unique identifier for the user or placeholder the allocation is assigned to. Must be provided together with 'workspace' if 'parent' is not specified.
Globally unique identifier for the workspace. Must be provided together with 'assignee' if 'parent' is not specified.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Defines a comma-separated list of optional fields for a more detailed project representation in the response, beyond the default compact view.
Pretty-prints the JSON response for readability, useful for debugging.
Globally unique identifier for the project. Must be a numeric string (e.g., '1234567890123456'). Use ASANA_GET_MULTIPLE_PROJECTS or ASANA_GET_WORKSPACE_PROJECTS to retrieve valid project IDs.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_A_TASKRetrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.
Input parameters
Globally unique identifier (GID) of the task.
Array of field names to include in the response for more detailed data beyond the default compact representation. Only specific field paths listed in the OptFieldsEnm0 enum are supported (not arbitrary nested paths). Examples of valid fields: assignee, due_on, name, notes, custom_fields.name, followers.name, parent.name.
If true, formats JSON response with indentation for readability; for debugging, as it increases response size/time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_ATTACHMENTTool to get a single attachment by its globally unique identifier. Use when you need to retrieve details about a specific file attached to a task or project.
Input parameters
A comma-separated list of fields to include in the response. For example: "name,size,url".
The globally unique identifier for the attachment.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_AUDIT_LOG_EVENTSTool to get audit log events for a workspace. Use when you need to retrieve a log of actions performed within a specific Asana workspace.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Filter to events created before this time (exclusive).
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
Filter to events created after this time (inclusive).
Filter to events triggered by the actor with this ID.
Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If actor_gid is included, this should be excluded.
Filter to events of this type. Refer to the supported audit log events for a full list of values.
Filter to events with this resource ID.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_A_USER_TASK_LISTRetrieves a specific user's task list from Asana by its `user_task_list_gid`, optionally returning extended details like name, owner, and workspace if specified in `opt_fields`.
Input parameters
The GID of the workspace to filter the user task list.
A list of optional field names to include in the response. By default, the response is compact and excludes some properties. Use this parameter to retrieve additional details. For example, to include the owner and workspace, provide `\["owner", "workspace"\]` as the value for this field.
Set to true to receive the API response in a pretty-printed JSON format. This is useful for debugging but may increase response size and processing time.
The user GID (not task list GID) to retrieve the task list for. This endpoint retrieves a user's task list by user GID, not by task list GID. Use 'me' for the authenticated user or a specific user GID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_CURRENT_USERRetrieves the authenticated user's full record, including accessible workspaces, often used as an initial call to establish user context for subsequent operations.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_CUSTOM_FIELDTool to get a single custom field by its globally unique identifier. Use when you need to retrieve the complete metadata and properties of a specific custom field in Asana.
Input parameters
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Globally unique identifier for the custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACETool to get all custom fields in a workspace. Use when you need to retrieve a list of custom fields associated with a specific workspace.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.
This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_CUSTOM_TYPESTool to get all custom types associated with a project. Use when you need to retrieve custom types that extend Asana objects for categorization purposes.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
Globally unique identifier for the project, which is used as a filter when retrieving all custom types.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_EVENTSRetrieve 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.
Input parameters
A sync token received from a previous events GET request. If provided, the API will return only events that have occurred since the sync token was created. If omitted, the API will return all events.
Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the resource.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_FAVORITES_FOR_USERTool to get a user's favorites within a specified workspace. Returns favorites ordered as they appear in the user's Asana sidebar.
Input parameters
Results per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
The workspace in which to get favorites.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
The resource type of favorites to be returned.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_GOALRetrieve the full record for a single goal by its GID.
Input parameters
Globally unique identifier for the goal.
Comma-separated list of fields to include in the response. Example: "name,notes,due_on"
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_GOAL_RELATIONSHIPSTool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.
Input parameters
The number of objects to return per page.
Offset token for pagination.
The globally unique identifier for the goal.
Defines fields to return.
Provides “pretty” output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Globally unique identifier for the team. Exactly one of workspace, team, portfolio, or project must be specified.
The number of results to return.
Offset token for pagination.
Globally unique identifier for the project. Exactly one of workspace, team, portfolio, or project must be specified.
Filter to archived goals.
Globally unique identifier for the portfolio. Exactly one of workspace, team, portfolio, or project must be specified.
Globally unique identifier for the workspace or organization. Exactly one of workspace, team, portfolio, or project must be specified.
Defines fields to return. Some requests support structured objects supporting cascades of multiple objects separated by commas; "data.gid" will return the gid field of the data object or "data.subtask.gid" will return the gid field of the subtask object.
Globally unique identifier for the time period.
Filter to goals at the workspace level.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Globally unique identifier for the job.
A comma-separated list of properties to include in the response. This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
If true, provides "pretty" (i.e., human-readable) JSON output. Formatting dates and times as human-readable strings, numbers as strings, and including newlines and indentation.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the membership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The number of results to return per page.
GID of the member (user or team) to filter memberships.
Offset token for pagination.
GID of the parent resource (e.g., project_gid, goal_gid, portfolio_gid, or custom_field_gid) to filter memberships.
Comma-separated list of fields to include in the response (e.g., "parent,member,access_level,parent.name,member.name").
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
GID of the team to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., '1205029116228052').
Number of projects to return per page (1-100).
Pagination offset token (JWT format) from a previous response's `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.
Filter projects by archived status: `True` for archived only, `False` for unarchived only.
GID of the workspace or organization to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., '1205029116228052'). To find your workspace GID, call GET /workspaces.
Array of optional properties to include for richer project details, as the default response is compact. This is an array, not a comma-separated string. See `OptFieldsEnm0` for available fields.
Return JSON in a 'pretty' format (indented, line breaks). For debugging only due to increased response size/time.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_MULTIPLE_TASKSRetrieves a list of tasks, allowing filtering by assignee (requires `workspace`), project, section, `completed_since`, and `modified_since`; `workspace` also requires `assignee`.
Input parameters
Tag GID to filter tasks. Mutually exclusive with project, section, user_task_list, or assignee+workspace.
Number of task objects to return per page (1-100). Required when using assignee+workspace; defaults to 50 if omitted for that filter combination.
Offset token for pagination, from next_page in a previous response. WARNING: Tokens expire after a short time. Use fresh tokens from recent API responses; do not cache for extended periods. If a token expires, restart pagination from the first page (omit offset).
Project GID to filter tasks. Mutually exclusive with section, tag, user_task_list, or assignee+workspace.
Section GID to filter tasks. Mutually exclusive with project, tag, user_task_list, or assignee+workspace.
User identifier: 'me' for current user or a numeric GID. Must be used with `workspace`. When using assignee+workspace, always set a `limit` (defaults to 50 if omitted).
Workspace GID. Must be used with `assignee`. Mutually exclusive with project, section, tag, or user_task_list.
Optional fields to include. Use 'projects' (plural) for project data. See OptFieldsEnm0 for valid values.
Format JSON output with indentation for debugging (may increase response time/size).
ISO 8601 date-time. Returns tasks modified since this time (includes property/association changes).
User task list GID to filter tasks. Mutually exclusive with project, section, tag, or assignee+workspace.
Filter for tasks incomplete or completed since this ISO 8601 date-time or 'now'.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The GID of the Asana team. Required when the authenticated user belongs to multiple workspaces (at least one of 'workspace' or 'team' must be provided). Filters results to users in this team.
The maximum number of user objects to return per page (1-100).
Opaque token for pagination to retrieve the subsequent page of results.
The GID of the Asana workspace or organization. Required when the authenticated user belongs to multiple workspaces (at least one of 'workspace' or 'team' must be provided). Filters results to users in this workspace.
A list of optional field names to include in the response for each user. Available fields include 'email', 'name', 'photo' (and its specific sizes like 'photo.image_1024x1024'), 'workspaces', 'uri', and 'offset'.
Return the response in a human-readable JSON format.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_MULTIPLE_WORKSPACESRetrieves all workspaces accessible by the authenticated user, returning an empty list if the user has no accessible workspaces.
Input parameters
The maximum number of workspace objects to return per page. Must be an integer between 1 and 100, inclusive.
An opaque token used for pagination, obtained from the 'next_page' object in a previous response. If not provided, the first page of results is returned. Note: Pass only an offset token from a previous paginated request for this endpoint.
A comma-separated list of optional properties to include in the response. By default, only a compact representation of the resource is returned. Available options: 'email_domains', 'is_organization', 'name', 'offset', 'path', 'uri'.
Set to true to receive the response in a human-readable JSON format with proper line breaking and indentation. Useful for debugging, but may increase response time and size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_PORTFOLIORetrieve the full record for a single portfolio by its GID. Use this when you need to get detailed information about a specific portfolio.
Input parameters
Results per page. Max 100.
Offset token for pagination.
Defines fields to return. Example: \["name", "color", "due_on"\]
Provides “pretty” output.
Globally unique identifier for the portfolio.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Number of results to return per page.
Offset token to request next page.
Fields to include in response. Common fields: archived, color, created_at, current_status_update, due_on, members, name, notes, owner, start_on, team, workspace.
Globally unique identifier for the portfolio.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the GID of a user.
Results per page. The number of objects to return per page. Must be between 1 and 100, inclusive.
Offset token. An offset to paginate from. This can be retrieved from the ‘next_page’ field in the previous response.
The GID of the portfolio to filter memberships on.
The GID of the workspace to filter memberships on.
Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_PORTFOLIOSRetrieve multiple portfolios. Use when you need to list portfolios within a specific workspace, optionally filtered by owner.
Input parameters
The number of objects to return per page. Must be between 1 and 100.
The user GID who owns the portfolio. Use 'me' to refer to the current authenticated user. This parameter is required by the Asana API.
An offset token for pagination.
The workspace or organization GID to filter portfolios on. Must be a non-empty numeric GID (e.g., '1205766922013215').
Fields to include in the response. For example: \['name', 'color', 'owner'\].
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Available options: text
Provides 'pretty' output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project brief. This is NOT the project GID. Must be a numeric string. To obtain a project_brief_gid, first call 'Get a project' with opt_fields=\['project_brief'\] to retrieve the project's brief object, which contains the project_brief_gid.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project membership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_PROJECTS_FOR_TASKTool to get all projects a task is in. Use when you need to retrieve project associations for a specific task.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.*
The task to operate on.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API.
Only return projects whose `archived` field takes on the value of this parameter.
Globally unique identifier for the team. Must be a numeric string (digits only).
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_PROJECT_STATUSTool to retrieve the full record for a single project status by its GID. Use when you need to get the details of a specific project status update.
Input parameters
Fields to include in the response.
Provides “pretty” output.
Globally unique identifier for the project status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to paginate from. This can be retrieved from the 'next_page' field in a previous response.
Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
Provides “pretty” output. Adds indentation and newlines to the response. This can be useful when debugging but increases the response size.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.
Globally unique identifier for the team. Recommended when working with organizations. REQUIRED: At least one of workspace_gid or team_gid must be provided. Accepts both 'team_gid' and 'team' as parameter names.
A comma-separated list of fields to include in the response. For example: name,description,owner,team,public
Globally unique identifier for a regular workspace (not an organization). Only accepts workspace GIDs - organization GIDs will be rejected. For organizations, use team_gid instead. REQUIRED: At least one of workspace_gid or team_gid must be provided. Accepts both 'workspace_gid' and 'workspace' as parameter names.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
Globally unique identifier for the team.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.
Only return reactions with this emoji base character.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
The globally unique identifier for the section.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_SECTIONS_IN_PROJECTReturns compact records for all sections (used to group tasks) in a specified project.
Input parameters
Number of sections to return per page (1-100).
Token for pagination to retrieve the next page of results.
Globally unique identifier (GID) of the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format with proper line breaking and indentation.
Globally unique identifier for the status update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The maximum number of items to return per page. The value must be between 1 and 100.
An offset token returned from a previous query that had a `next_page` property. This is used for pagination.
Globally unique identifier (GID) of the object (project, portfolio, or goal) from which to fetch status updates.
A comma-separated list of fields to include in the response. This allows customization of the returned data.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_STORIES_FOR_TASKTool to get stories (comments, status updates, etc.) for a task. Use when you need to retrieve the history or discussion associated with a specific task.
Input parameters
Results per page. The number of results per page (between 1 and 100).
Offset token for pagination.
The GID of the task to get stories from.
A comma-separated list of optional properties to include in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_STORYTool to retrieve a story. Use when you need to get the complete record for a single story.
Input parameters
Globally unique identifier for the story.
A comma-separated list of fields to include in the response.
Provides "pretty" output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TAGTool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.
Input parameters
Globally unique identifier for the tag.
A comma-separated list of properties to include in the response.
If true, provides "pretty" (i.e., human-readable) JSON output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TAGSGet multiple tags in a workspace.
Input parameters
Results per page.
Offset token for pagination.
The GID of the workspace to filter tags on.
Comma-separated list of optional properties to include in the response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TAGS_FOR_TASKTool to get all tags associated with a specific task. Use when you need to retrieve tags for categorization, filtering, or understanding task organization.
Input parameters
Results per page. The value must be between 1 and 100.
Offset token for pagination. An offset to the next page returned by the API.
Globally unique identifier for the task.
A comma-separated list of properties to include in the response.
If true, provides "pretty" (i.e., human-readable) JSON output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TAGS_FOR_WORKSPACETool to get all tags in a specific workspace. Use when you need to retrieve tags for categorizing tasks within a workspace.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The number of results per page.
An offset token, used for pagination to retrieve the next page of results. If not provided or empty, the first page of results is returned.
A comma-separated list of fields to include in the response for each attachment. Possible fields include: `created_at`, `download_url`, `host`, `name`, `parent`, `parent.name`, `permanent_url`, `resource_subtype`, `size`, `view_url`.
The GID of the task, project, or project_brief to fetch attachments from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Comma-separated list of fields to include in the response. Available fields: num_tasks, num_completed_tasks, num_incomplete_tasks, num_milestones, num_completed_milestones, num_incomplete_milestones. All fields are excluded by default, so you must opt in using this parameter to get any information from this endpoint.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
Globally unique identifier for the tag.
This endpoint returns a compact representation of a resource by default. To include optional properties, set this query parameter to a comma-separated list of the properties you wish to include (e.g., 'name', 'completed', 'due_on', 'assignee').
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
This endpoint returns a compact representation of a resource. To include additional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string (ISO 8601 format) or the keyword 'now'.
Globally unique identifier (GID) of the user task list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TASKS_FROM_A_PROJECTRetrieves tasks from a specified Asana project, allowing filtering by completion status and selection of optional fields for detailed responses.
Input parameters
Maximum number of tasks to return per page. Defaults to 100 to enable pagination and avoid API errors on large projects.
Opaque pagination token from a previous response's 'next_page.offset' field. Must be passed exactly as received without any modification or truncation. If omitted or empty, returns the first page. Tokens expire after some time.
Optional fields for a detailed task representation (e.g., 'assignee', 'due_on'), as tasks are compact by default. Refer to Asana API docs for all field names.
If true, returns human-readable JSON; useful for debugging but increases response size.
Globally unique identifier (GID) of the project.
Filters tasks: returns incomplete tasks or those completed after the specified ISO 8601 date-time (e.g., '2023-10-26T10:00:00Z') or 'now'. If omitted or empty, no completion filter is applied.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Maximum number of tasks to return per page (1-100).
Opaque pagination token from a previous response's 'next_page.offset' field. Must be passed exactly as received without any modification or truncation. If omitted or empty, returns the first page. Tokens expire after some time.
Optional fields for a detailed task representation (e.g., 'assignee', 'due_on', 'completed_at'). By default, tasks are returned in compact format. Use this to request specific fields. Refer to Asana API docs for all available field names.
If true, returns human-readable JSON; useful for debugging but increases response size.
Globally unique identifier (GID) of the section.
Filters tasks: returns incomplete tasks or those completed after the specified ISO 8601 date-time (e.g., '2023-10-26T10:00:00Z') or 'now'. Omit to retrieve all tasks in the section.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TASK_SUBTASKSTool to retrieve multiple task subtasks from a workspace. Use when you need to list or find available task subtasks.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
The globally unique identifier for the task.
Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TASK_TEMPLATESTool to retrieve multiple task templates from a workspace. Use when you need to list or find available task templates.
Input parameters
The number of objects to return per page.
Offset token for pagination.
Comma-separated list of fields to include in the response. For example: 'name,created_at,created_by'.
Globally unique identifier for the project. One of project or workspace must be specified.
Globally unique identifier for the workspace. One of project or workspace must be specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Globally unique identifier for the team.
Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths. The id of included objects will always be returned, regardless of the field options.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the team membership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TEAM_MEMBERSHIPSTool 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.
Input parameters
The team to filter memberships to.
A user gid to filter memberships to.
Results per page.
Offset token.
The workspace to filter memberships to.
Defines fields to return.
Adds indentation to JSON response.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
Globally unique identifier for the team.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TEAM_MEMBERSHIPS_FOR_USERTool to get team memberships for a specific user. Use when you need to retrieve all teams that a user belongs to within a workspace.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Globally unique identifier for the workspace.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TEAMS_FOR_USERTool 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.
Input parameters
Results per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
The workspace or organization to filter teams on.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TEAMS_IN_WORKSPACEReturns the compact records for all teams in the workspace visible to the authorized user.
Input parameters
Results per page. The value must be between 1 and 100.
Offset token from a previous API response for pagination to retrieve the next page of results. If an offset is not passed in, the API will return the first page of results.
The Global ID (GID) of the workspace to get teams from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Comma-separated list of fields to include in the response.
Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Globally unique identifier for the time period.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_TIME_PERIODSTool to retrieve compact or full representations of time periods. Use this when you need to fetch information about specific time periods, such as their start and end dates, display names, and parent periods.
Input parameters
Results per page.
The last day of the time period, YYYY-MM-DD.
Offset token for pagination.
The first day of the time period, YYYY-MM-DD.
A comma-separated list of fields to include in the response.
Provides the response in "pretty" output.
Globally unique identifier for the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Globally unique identifier for the task to filter time tracking entries by.
Globally unique identifier for the user to filter time tracking entries by.
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.*
Globally unique identifier for the portfolio to filter time tracking entries by.
Globally unique identifier for the workspace. At least one of entered_on_start_date or entered_on_end_date must be provided when filtering by workspace.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project the time tracking entries are attributed to.
The end date for filtering time tracking entries by when they were entered.
The start date for filtering time tracking entries by when they were entered.
Globally unique identifier for the timesheet approval status to filter time tracking entries by.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. *Note: You can only pass in an offset that was returned to you via a previously paginated request.*
The task to operate on.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The number of results to return. The default is 20 if this parameter is omitted, with a minimum of 1 and a maximum of 100.
The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
The type of values the typeahead should return.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_USERGet a user by their ID.
Input parameters
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_USERS_FOR_TEAMGet users in a team.
Input parameters
Results per page. The maximum is 2000.
Offset token.
Globally unique identifier for the team.
This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_USERS_FOR_WORKSPACEGet users in a workspace or organization.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token for pagination requests.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the user task list.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_WEBHOOKSTool 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.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token for pagination. An offset to the next page returned by the API.
Only return webhooks for the given resource.
The workspace to query for webhooks in.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This results in a compact response, suitable for data-transfer sensitive applications. Valid values are: gid, name, resource_type, email_domains, is_organization.
Provides “pretty” output. Formatting dates and times as human-readable strings, numbers as strings, and including newlines and indentation. The default value is false.
The globally unique identifier of the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the workspace membership.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token.
Defines fields to return. Some requests return compact representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should return for each object. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
Globally unique identifier for the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_WORKSPACE_MEMBERSHIPS_FOR_USERTool to retrieve workspace memberships for a specific user. Use when you need to list all workspaces a user is a member of.
Input parameters
Results per page. The number of objects to return per page. The value must be between 1 and 100.
Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results.
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_GET_WORKSPACE_PROJECTSTool to retrieve the projects associated with a specific workspace. Use when you need to list all projects within a given Asana workspace.
Input parameters
Number of objects to return per page. For workspaces with many projects, this parameter is required to avoid pagination errors. Use the offset parameter to retrieve additional pages.
Offset token for pagination.
Fields to expand in the response.
Fields to include in the response.
Globally unique identifier for the workspace.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The data for the enum option to be inserted or reordered.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
Globally unique identifier for the custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The data specifying which section to move and where to position it.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The name for the new project that will be created from the template.
Globally unique identifier for the team that the new project will belong to. Required if the template is a team template.
If true, requires all date and role variables from the template to be provided. If false or omitted, missing variables will use defaults.
Optional fields to include in the response. Common values: gid, status, new_project, new_project_template.
If true, returns human-readable JSON response (for debugging only due to size/processing impact).
Privacy setting for the new project. If not specified, inherits from template or team settings.
Array of date variable assignments. Required if the template includes date variables and is_strict is true.
Array of role assignments mapping template roles to specific users.
Globally unique identifier for the project template to instantiate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_REJECT_ACCESS_REQUESTTool to reject an access request. Use when you need to deny a user's request for access to a project or resource.
Input parameters
Globally unique identifier for the access request to reject. Must be a numeric string.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_REMOVE_FOLLOWER_FROM_TASKTool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.
Input parameters
The globally unique identifier for the task.
An array of user GIDs to remove as followers.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A comma-separated string of user identifiers. These can be the string "me", an email, or the gid of a user. For example: "521621,621373" or "me,user@example.com".
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier (GID) of the item (project or portfolio) to remove from the portfolio.
Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
Provides 'pretty' output. Provides the response in a 'pretty' format with proper line breaking and indentation for readability. This will take extra time and increase the response size so it is advisable only to use this during debugging.
The globally unique identifier for the portfolio.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A comma-separated string of user identifiers. These can be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The project to remove the task from.
The task to operate on.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The globally unique identifier for the tag to remove from the task.
The globally unique identifier for the task.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string 'me', an email, or the gid of a user.
Globally unique identifier for the team.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
Provides "pretty" output. Provides the response in a "pretty" format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_SEARCH_TASKS_IN_WORKSPACETool to search tasks across a workspace with advanced filters. Use when performing complex queries such as overdue tasks, by project or custom field, for reporting or automation.
Input parameters
Search for tasks containing this text in name or notes. At least one search filter must be provided.
Maximum number of results to return (1-100).
Additional fields to include in each task object; see Asana API docs for available fields.
Pretty-print the JSON response with indentation (useful for debugging).
Return tasks assigned to any of these user GIDs; use 'me' for current user or 'null' for unassigned tasks. At least one search filter must be provided.
Return tasks in any of these project GIDs. Must contain valid numeric Asana project identifiers (e.g., '1205766922013215'). At least one search filter (projects_any, assignee_any, resource_subtype, or text) must be provided.
Numeric GID of the workspace to search. Must be a valid numeric workspace identifier (e.g., '1205766922013215'). Note: Unlike assignee_any, 'me' is not a valid value for workspace_gid - use a numeric GID obtained from the workspaces endpoint.
Filter by task subtype: 'default_task' for regular tasks, 'milestone' for milestones. At least one search filter must be provided.
Message explaining any automatic modifications made to the request.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The GID of the new parent task, or 'null' to remove the parent. Setting a parent makes this task a subtask of the parent.
The globally unique identifier (GID) of the task to set the parent for.
Comma-separated list of fields to include in the response. By default, the response returns a compact representation of the task. Use this to retrieve additional fields such as 'name', 'parent', 'parent.name', etc.
Provides 'pretty' output with proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
A subtask GID of the parent to insert the task after, or 'null' to insert at the beginning of the subtask list. If not provided, the task will be inserted at an appropriate position.
A subtask GID of the parent to insert the task before, or 'null' to insert at the end of the subtask list. If not provided, the task will be inserted at an appropriate position.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_SUBMIT_PARALLEL_REQUESTSTool to submit multiple Asana API requests in parallel using the Batch API. Use when you need to perform several operations efficiently, such as fetching multiple tasks or creating multiple subtasks at once.
Input parameters
Contains the list of actions to be performed in parallel.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_ALLOCATIONTool 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.
Input parameters
The data to update the allocation with.
A comma-separated list of fields to include in the response.
If true, the response will be in a human-readable format.
Globally unique identifier for the allocation to be updated.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_A_TASKUpdates attributes of an existing Asana task identified by its task_gid.
Input parameters
An object containing the fields of the task to update.
The GID of the task to update.
Array of optional properties to include in the response object. By default, a compact representation of the task is returned. Use this to retrieve additional fields. The elements of this list should be valid field names for the task resource. This is an array, not a comma-separated string.
If true, the response JSON will be 'pretty-printed' with indentation and line breaks, making it more readable. This is useful for debugging but may increase response time and size.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_CUSTOM_FIELDTool to update a custom field by its globally unique identifier. Use when you need to modify properties of an existing custom field in Asana.
Input parameters
The data to update the custom field with.
This endpoint returns a compact resource, which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides “pretty” output.
Globally unique identifier for the custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The data to update the enum option with.
Defines the fields to be returned in the response.
Provides “pretty” output. Formatting of the result will follow JSON pretty print conventions (line breaks and indentation).
Globally unique identifier for the enum option.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_PROJECTUpdate a project.
Input parameters
The name of the project. Note: User task lists (My Tasks) are special system-managed projects whose names cannot be changed. Attempting to rename a user task list will result in an error.
The GID of the team that this project is shared with.
Color of the project.
Free-form textual information associated with the project (its description).
The GID of the new owner of the project. May be null.
The day on which this project is due. This takes a date with format YYYY-MM-DD.
True if the project is public to its team.
True if the project is archived, false if not.
The localized day on which this project is due. This takes a date with format YYYY-MM-DD.
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format.
\[Opt In\](/docs/input-output-options). The notes of the project with formatting as HTML.
\[Opt In\](/docs/input-output-options). True if the project is a template.
The GID of the project to update.
The default view (list, board, calendar, or timeline) of a project.
An object where each key is the GID of a custom field and its corresponding value is the new value for that custom field.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The plain text content of the project brief. This field updates the main content/description of the project brief.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Available options: html_text, permalink_url, project, project.name, text, title
Provides 'pretty' output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Globally unique identifier for the project brief. This is NOT the project GID. Must be a numeric string. To obtain a project_brief_gid, first call 'Get a project' with opt_fields=\['project_brief'\] to retrieve the project's brief object, which contains the project_brief_gid.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The new name for the section. This is the text displayed as the section header. Cannot be an empty string.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output with proper line breaking and indentation. Advisable only during debugging as it increases response time and size.
The globally unique identifier for the section to update.
An existing section within this project after which the section should be inserted. Cannot be provided together with insert_before.
An existing section within this project before which the section should be inserted. Cannot be provided together with insert_after.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
An object containing the fields of the story to update.
Globally unique identifier for the story.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_TAGTool to update an existing tag by its globally unique identifier. Use when you need to change the name or color of a tag.
Input parameters
An object containing the fields to update.
The globally unique identifier for the tag.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_TEAMTool to update details of an existing team. Use when you need to change a team's name, description, or organization.
Input parameters
The new name of the team.
Globally unique identifier for the team.
Defines fields to return.
Provides “pretty” output.
The new description of the team.
GID of the organization to which the team belongs. This is the GID of an organization, not its name.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
The workspace to filter results on.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
An object where each key is a custom field GID and the value is the new value for that custom field. Note: User objects have very limited update capabilities in Asana's API.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
A string identifying a user. This can either be the string "me", an email, or the gid of a user.
This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include.
Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
Object mapping custom field GIDs to their values for the user. Values depend on field type: enum fields use option GIDs (strings), text fields use strings, number fields use numbers.
Globally unique identifier for the workspace or organization.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
ASANA_UPDATE_WEBHOOKTool to update an existing Asana webhook's filter configuration. Use when you need to modify which events trigger webhook notifications.
Input parameters
Array of WebhookFilter objects to specify which events should trigger this webhook. If a webhook event passes any of the filters, the event will be delivered; otherwise no event will be sent. Each filter can specify resource_type, resource_subtype, action, and/or fields to match.
Array of optional field names to include in the response. Common fields include: 'active', 'created_at', 'filters', 'last_failure_at', 'last_success_at', 'resource', 'target'.
If true, the response JSON will be 'pretty-printed' with indentation and line breaks for readability. Useful for debugging but may increase response time and size.
Globally unique identifier for the webhook to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 56 agents privately built on Nagent that already use Asana.
Build on Nagent
Connect Asana to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Asana, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Asana is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Asana is connected, you configure its 153 actions and 6 triggers directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Asana steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Asana event fires, the agent kicks off automatically.
Every Asana action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Asana ships with 153 pre-built project management actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Asana together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Asana-based workflows tailored to your business.