Skip to main content
Asana logo
  • Category: project management
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 157
  • Triggers: 6
  • Slug: ASANA
  • Version: 20261101_00

Frequently Asked Questions

For a step-by-step guide on creating and configuring your own Asana OAuth credentials with Composio, see How to create OAuth credentials for Asana.

Tools

Slug: ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_GOALAdd a custom field to a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
Data
string
required
Globally unique identifier for the goal.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PORTFOLIOAdd a custom field to a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
Data
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PROJECTAdd a custom field to a project.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ADD_FOLLOWERS_TO_GOALAdd a collaborator to a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
Data
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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.
array
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.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the task.
array
required
An array of user GIDs to add as followers to the task. For example: [“12345”, “67890”].
array
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”].
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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.
string
GID of a portfolio item after which to insert the new item. Mutually exclusive with insert_before.
string
GID of a portfolio item before which to insert the new item. Mutually exclusive with insert_after.
string
required
The globally unique identifier (GID) of the portfolio to add the item to. Must be a numeric string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ADD_MEMBERS_FOR_PORTFOLIOAdd users to a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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”.
array
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”].
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the project to add to the task.
string
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.
string
required
The globally unique identifier for the task to add a project to.
boolean
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.
string
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.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The request data for adding a supporting relationship.
string
required
Globally unique identifier for the goal.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the tag to add. The tag must already exist in the workspace.
string
required
The globally unique identifier for the task.
string
Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the task that will depend on other tasks.
string
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.
boolean
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.
array
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ADD_TASK_DEPENDENTSMark tasks as dependents of an Asana prerequisite task, if not already linked. A task can have at most 30 dependents and dependencies combined. This adds relationships without creating or deleting tasks.

Input Parameters

string
required
The globally unique identifier of the prerequisite task to operate on.
array
required
Task GIDs to mark as dependents of this task. These tasks depend on the target task, not the reverse.
boolean
Pretty-print the response with line breaks and indentation. This increases response size and processing time; use only for debugging.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The GID of the existing task to add to the section. Must be a numeric string.
string
required
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.
string
GID of a task in the section after which to insert the current task. Mutually exclusive with insert_before.
string
GID of a task in the section before which to insert the current task. Mutually exclusive with insert_after.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
string
required
Globally unique identifier for the team.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Comma-separated list of fields to include in the response.
boolean
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.
string
required
Globally unique identifier for the access request to approve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier (gid) of the access requestable object that the user is requesting access to. Supports projects and portfolios.
string
The optional message to include with the access request. This can be used to provide context or additional information about the request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_ALLOCATIONCreates an allocation for a user in a workspace over a defined period, with an effort value in hours or percent and an optional project association.

Input Parameters

string
Any additional notes related to the allocation.
string
required
The end date of the allocation. The format is YYYY-MM-DD.
string
required
The start date of the allocation. The format is YYYY-MM-DD.
string ("hours" | "percent")
required
The unit type for tracking effort on the allocation. Must be either ‘hours’ or ‘percent’.
string
The project GID for which this allocation is being made. If provided, the allocation will be linked to this project.
string
required
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.
number
required
The numeric effort value for the allocation. Represents hours per week if effort_type is ‘hours’, or percentage if effort_type is ‘percent’.
string
required
The ID of the workspace where the allocation will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
Data payload for the new project.
array
Array of optional properties to include in the response.
boolean
True for human-readable JSON response (debugging only due to size/processing).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The properties for the tag creation, including name (required), color (optional), and notes (optional).
array
List of fields from OptFieldsEnm0 (e.g., ‘name’, ‘color’) to include in the response; returns a compact representation by default.
boolean
If true, pretty-prints the JSON response; useful for debugging but may increase response size.
string
required
The globally unique identifier (GID) for the workspace or organization in which to create the tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
Task details for creation.
array
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.
boolean
Provides ‘pretty’ JSON output with line breaks/indentation. Useful for debugging; may increase response time/size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
The URL of the external resource being attached. Required for attachments of type ‘external’. Mutually exclusive with ‘file’.
object
Required for ‘asana’ attachments. This field should be provided when uploading a file. Mutually exclusive with ‘url’.
string
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.
string
required
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.
boolean
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.
string ("asana" | "external")
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The file to upload.
string
required
Globally unique identifier for the parent task or comment.
boolean
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.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_BUDGETCreate a budget.

Input Parameters

object
required
A budget object represents a budget for a given parent.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The custom field object to create.
array
Comma-separated list of properties to include in the response.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The enum option to create.
array
Defines fields to return.
boolean
Provides “pretty” output.
string
required
Globally unique identifier for the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_GOALCreate a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_GOAL_METRICCreate a goal metric. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Role of the member in the parent resource. This is an optional parameter.
string
required
GID of the member (user or team) to add to the parent resource. Must be a numeric GID string (e.g., ‘1210124065021206’).
string
required
GID of the parent resource (project, goal, or portfolio) to add the member to. Must be a numeric GID string (e.g., ‘1210474562469922’).
boolean
Provides ‘pretty’ output with proper line breaking and indentation for debugging. May increase response size.
string
Access level for the member in the parent resource. Common values: ‘admin’, ‘editor’, ‘commenter’, ‘viewer’. Defaults to ‘editor’ if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_OOO_ENTRYCreate an OOO entry.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_PORTFOLIOCreate a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
A portfolio gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent project status update. Portfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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>’.
array
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
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
Project data payload containing the project details to create.
string
required
Globally unique identifier for the team. This is the team where the project will be created.
array
Array of optional field names to include in the response (e.g., ‘name’, ‘notes’, ‘owner’, ‘workspace.name’). By default, some properties are excluded.
boolean
Provides ‘pretty’ output with proper line breaking and indentation for debugging. Note: increases response size and processing time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
Project data payload containing the project details to create.
array
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.
boolean
Provides ‘pretty’ output with proper line breaking and indentation for debugging. Note: increases response size and processing time.
string
required
Globally unique identifier for the workspace or organization where the project will be created.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The HTML content of the status update.
string ("GREEN" | "YELLOW" | "RED" | "BLUE" | "COMPLETE")
required
Color of the status update. Supported values: GREEN, YELLOW, RED, BLUE, COMPLETE.
string
required
The title of the project status update.
string
required
Globally unique identifier for the project.
string ("on_track" | "at_risk" | "off_track" | "on_hold" | "complete")
required
The type of status. Must be one of: on_track, at_risk, off_track, on_hold, complete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_RATECreate a rate.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_ROLECreate a role.

Input Parameters

object
required
A role represents a group of permissions that can be assigned to a user or team.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Name for the new section. This is a section name (e.g., ‘To Do’, ‘In Progress’), NOT a task name.
string
required
GID of the project where the section will be created. Must be a valid project GID.
string
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.
string
GID of an existing section to insert the new section before; if omitted, the new section is added at the end.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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.
string
The title of the status update. If not provided, Asana may auto-generate a title based on the status_type.
string
required
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’).
array
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.
boolean
Provides ‘pretty’ JSON output with line breaks and indentation. Useful for debugging; may increase response time and size.
string ("on_track" | "at_risk" | "off_track" | "on_hold" | "complete")
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_STORY_FOR_GOALCreate a story on a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A story represents an activity associated with an object in the Asana system.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The name of the subtask to be created.
string
Optional descriptive text for the subtask.
string
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.
string
Optional due date for the subtask in YYYY-MM-DD format, representing the end of the day for the task.
string
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.
string
required
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.
boolean
Optional flag to mark the subtask as completed upon creation. Defaults to false if not specified.
array
Optional array of user Global IDs (GIDs) to add as followers to the subtask. Followers receive notifications about subtask updates.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The properties for the tag to be created.
array
List of field names to include in the response. Common fields: color, created_at, followers, name, notes, permalink_url, workspace.
boolean
If true, provides pretty-printed JSON response. Useful for debugging but may increase response size.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_TASK_COMMENTAdds a new text comment (story) to an existing Asana task, appearing in its activity feed.

Input Parameters

string
required
The plain text content of the comment to be posted on the task. HTML or rich text is not supported via this field.
string
required
The globally unique identifier (GID) of the Asana task to which the comment will be added.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_TEAMCreates a new team in a specified Asana organization for collaboration.

Input Parameters

object
required
The request data for creating a team.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_TIMESHEET_APPROVAL_STATUSCreate a timesheet approval status.

Input Parameters

object
required
A request to create a timesheet approval status.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_TIME_TRACKING_CATEGORYCreate a time tracking category.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_CREATE_TIME_TRACKING_ENTRYCreate a time tracking entry.

Input Parameters

object
required
Data
string
required
The task to operate on.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the allocation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
Provides “pretty” output.
string
required
Globally unique identifier for the attachment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_BUDGETDelete a budget.

Input Parameters

string
required
Globally unique identifier for the budget.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Globally unique identifier for the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_GOALDelete a goal. Requires an Asana subscription with Goals access.

Input Parameters

string
required
Globally unique identifier for the goal.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_OOO_ENTRYDelete an OOO entry.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the OOO entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_PORTFOLIODelete a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_PROJECTDelete a project.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the project brief to delete. Must be a numeric string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the project status to delete. Must be a numeric string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_PROJECT_TEMPLATEDelete a project template.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the project template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_RATEDelete a rate.

Input Parameters

string
required
Globally unique identifier for the rate.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_ROLEDelete a role.

Input Parameters

string
required
Globally unique identifier for the role.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_SECTIONTool to delete a section by its GID. Use when you need to permanently remove a section from a project.

Input Parameters

boolean
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.
string
required
The globally unique identifier for the section to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the status update to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_STORYTool to delete a story by its GID. Use when you need to remove a story from Asana.

Input Parameters

string
required
Globally unique identifier for the story.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_TAGTool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.

Input Parameters

string
required
The globally unique identifier for the tag.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_TASKDelete a task.

Input Parameters

string
required
Globally unique identifier for the task to delete. Must be a numeric string.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_TASK_TEMPLATEDelete a task template.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the task template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_TIME_TRACKING_CATEGORYDelete a time tracking category.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the time tracking category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_TIME_TRACKING_ENTRYDelete a time tracking entry.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the time tracking entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DELETE_WEBHOOKDelete a webhook.

Input Parameters

boolean
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.
string
required
Globally unique identifier for the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DUPLICATE_PORTFOLIODuplicate a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DUPLICATE_PROJECTDuplicate a project with a new name. Returns a duplication job and details of the new project.

Input Parameters

string
required
The name of the new project.
string
Globally unique identifier for the team that the new project will belong to.
array
A list of elements to be included in the duplication.
string
required
Globally unique identifier for the project to be duplicated.
object
Scheduling information for the new project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_DUPLICATE_TASKDuplicate a task, returning an asynchronous job record. Optionally specify the new task name and properties to copy.

Input Parameters

string
The name of the new task.
array
List of properties to copy from the original task.
string
required
The globally unique identifier for the task to be duplicated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
string
required
Globally unique identifier for the target object.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_AI_STUDIO_RUNSGet AI Studio credit utilization. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Filter to runs whose usage was recorded before this time (exclusive) — by when the run’s credit usage was recorded, not by run_started_at. Defaults to the time of the request.
string
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.
string
Inclusive lower bound. Runs are ordered and filtered by when their usage was recorded (the monotonic timestamp used for incremental polling), not by run_started_at. Omitted ⇒ the 2025-01-08 floor — no credit data exists before then, and there is no limit on how far back you can query. A value earlier than 2025-01-08 is treated as 2025-01-08 (not rejected), matching the audit log.
string
Scope results to a single division (its gid). Omitted ⇒ the org’s first licensed division. Use this to retrieve only one division’s slice (e.g. for a division-level admin or billing owner) rather than the whole organization.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_AI_STUDIO_SEATSGet AI Studio seats. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string ("active" | "revoked")
Filter seats to this state.
string
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.
string
Scope results to a single division (its gid). Omitted ⇒ the org’s first licensed division. Use this to retrieve only one division’s slice (e.g. for a division-level admin or billing owner) rather than the whole organization.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_ALLOCATIONGet an allocation by ID. Use when you need to retrieve the details of a specific allocation.

Input Parameters

array
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.
boolean
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.
string
required
Globally unique identifier for the allocation.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_ALLOCATIONSTool to get multiple allocations. Requires either ‘parent’ (project GID) OR both ‘assignee’ AND ‘workspace’ together.

Input Parameters

integer
Results per page.
string
Offset token.
string
Globally unique identifier for the project to filter allocations by. Required if ‘assignee’ and ‘workspace’ are not both provided.
string
Globally unique identifier for the user or placeholder the allocation is assigned to. Must be provided together with ‘workspace’ if ‘parent’ is not specified.
string
Globally unique identifier for the workspace. Must be provided together with ‘assignee’ if ‘parent’ is not specified.
array
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.
boolean
Provides ‘pretty’ output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
Defines a comma-separated list of optional fields for a more detailed project representation in the response, beyond the default compact view.
boolean
Pretty-prints the JSON response for readability, useful for debugging.
string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_A_TASKRetrieves full details for a specified task GID accessible by the user; use opt_fields to customize returned data.

Input Parameters

string
required
Globally unique identifier (GID) of the task.
array
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.
boolean
If true, formats JSON response with indentation for readability; for debugging, as it increases response size/time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
A comma-separated list of fields to include in the response. For example: “name,size,url”.
string
required
The globally unique identifier for the attachment.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_AUDIT_LOG_EVENTSRetrieve audit log events for a workspace or organization, with optional filters. Asana requires a service account for audit log access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Filter to events created before this time (exclusive).
string
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.
string
Filter to events created after this time (inclusive).
string
Filter to events triggered by the actor with this ID.
string
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.
string
Filter to events of this type. Refer to the supported audit log events for a full list of values.
string
Filter to events with this resource ID.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_A_USER_TASK_LISTRetrieves a user’s Asana task list for a specified workspace, using the user GID or me in user_task_list_gid. Optionally requests fields such as name, owner, and workspace using opt_fields.

Input Parameters

string
required
The GID of the workspace to filter the user task list.
array
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.
boolean
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.
string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_BUDGETGet a budget.

Input Parameters

string
required
Globally unique identifier for the budget.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_BUDGETSGet all budgets.

Input Parameters

string
required
Globally unique identifier for the budget’s parent object. This currently can only be a project.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CURRENT_USERRetrieve the authenticated user, including accessible workspaces, for establishing user context.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_FIELDRetrieve a custom field by its globally unique identifier, with optional selection of returned properties.

Input Parameters

array
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.
boolean
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
string
required
Globally unique identifier for the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_GOALGet a goal’s custom fields. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_PORTFOLIOGet a portfolio’s custom fields. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_TEAMGet a team’s custom fields.

Input Parameters

string
required
Globally unique identifier for the team.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACEList custom fields in a workspace, returning a page of results and pagination information when available.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_TYPEGet a custom type.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the custom type.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_CUSTOM_TYPESList custom types associated with a project, returning a page of results and pagination information when available.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the project, which is used as a filter when retrieving all custom types.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_EVENTSRetrieve events on an Asana resource to monitor changes using a sync token. A 412 response is returned as an empty event list with a new sync token for subsequent calls.

Input Parameters

string
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.
array
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.
boolean
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.
string
required
Globally unique identifier for the resource.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_FAVORITES_FOR_USERGet a user’s favorites of a selected resource type within a workspace, ordered as they appear in the Asana sidebar. The resource type defaults to projects.

Input Parameters

integer
Results per page. The value must be between 1 and 100.
string
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.
string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
string
required
The workspace in which to get favorites.
array
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.
boolean
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.
string ("portfolio" | "project" | "tag" | "task" | "user" | "project_template")
The resource type of favorites to be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_GOALRetrieve a single goal by its GID, with optional field selection.

Input Parameters

string
required
Globally unique identifier for the goal.
string
Comma-separated list of fields to include in the response. Example: “name,notes,due_on”

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_GOAL_RELATIONSHIPGet a goal relationship. Requires an Asana subscription with Goals access.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the goal relationship.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
The number of objects to return per page.
string
Offset token for pagination.
string
required
The globally unique identifier for the goal.
array
Defines fields to return.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Globally unique identifier for the team. Exactly one of workspace, team, portfolio, or project must be specified.
integer
The number of results to return.
string
Offset token for pagination.
string
Globally unique identifier for the project. Exactly one of workspace, team, portfolio, or project must be specified.
boolean
Filter to archived goals.
string
Globally unique identifier for the portfolio. Exactly one of workspace, team, portfolio, or project must be specified.
string
Globally unique identifier for the workspace or organization. Exactly one of workspace, team, portfolio, or project must be specified.
array
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.
string
Globally unique identifier for the time period.
boolean
Filter to goals at the workspace level.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Globally unique identifier for the job.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

boolean
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.
string
required
Globally unique identifier for the membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
The number of results to return per page.
string
GID of the member (user or team) to filter memberships.
string
Offset token for pagination.
string
GID of the parent resource (e.g., project_gid, goal_gid, portfolio_gid, or custom_field_gid) to filter memberships.
string
Comma-separated list of fields to include in the response (e.g., “parent,member,access_level,parent.name,member.name”).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
GID of the team to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., ‘1205029116228052’).
integer
Number of projects to return per page (1-100).
string
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.
boolean
Filter projects by archived status: True for archived only, False for unarchived only.
string
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
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.
boolean
Return JSON in a ‘pretty’ format (indented, line breaks). For debugging only due to increased response size/time.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_MULTIPLE_TASKSRetrieve tasks using exactly one scope: a project, section, tag, user task list, or assignee and workspace together. Supports completed-since and modified-since filters and pagination.

Input Parameters

string
Tag GID to filter tasks. Mutually exclusive with project, section, user_task_list, or assignee+workspace.
integer
Number of task objects to return per page (1-100). Required when using assignee+workspace; defaults to 50 if omitted for that filter combination.
string
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).
string
Project GID to filter tasks. Mutually exclusive with section, tag, user_task_list, or assignee+workspace.
string
Section GID to filter tasks. Mutually exclusive with project, tag, user_task_list, or assignee+workspace.
string
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).
string
Workspace GID. Must be used with assignee. Mutually exclusive with project, section, tag, or user_task_list.
array
Optional fields to include. Use ‘projects’ (plural) for project data. See OptFieldsEnm0 for valid values.
boolean
Format JSON output with indentation for debugging (may increase response time/size).
string
ISO 8601 date-time. Returns tasks modified since this time (includes property/association changes).
string
User task list GID to filter tasks. Mutually exclusive with project, section, tag, or assignee+workspace.
string
Filter for tasks incomplete or completed since this ISO 8601 date-time or ‘now’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
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.
integer
The maximum number of user objects to return per page (1-100).
string
Opaque token for pagination to retrieve the subsequent page of results.
string
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.
array
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’.
boolean
Return the response in a human-readable JSON format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_MULTIPLE_WORKSPACESRetrieve workspaces accessible to the authenticated user, with pagination support.

Input Parameters

integer
The maximum number of workspace objects to return per page. Must be an integer between 1 and 100, inclusive.
string
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.
array
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’.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_OOO_ENTRIESGet one page of out-of-office entries for a user in a workspace. Use optional date filters to find overlapping entries. To continue, pass the returned next_page.offset with the same user, workspace, and filters.

Input Parameters

string
required
Globally unique identifier for the user to filter OOO entries by.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token for the next page returned by the API. If omitted, the first page is returned. Only pass an offset returned by a previously paginated request.
string
An ISO 8601 date string. Filters to OOO entries that overlap with or start before this date.
string
required
Globally unique identifier for the workspace.
array
Properties to include that are excluded by default. Serialized as a comma-separated list; nested fields are supported. See https://developers.asana.com/docs/inputoutput-options#selecting-nested-fields.
boolean
Pretty-print the JSON response for debugging.
string
An ISO 8601 date string. Filters to OOO entries that overlap with or end after this date.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_OOO_ENTRYGet an OOO entry.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the OOO entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PARENT_GOALS_FOR_GOALGet parent goals from a goal. Requires an Asana subscription with Goals access.

Input Parameters

string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PORTFOLIORetrieve a single portfolio by its GID, with optional fields for portfolio details.

Input Parameters

integer
Results per page. Max 100.
string
Offset token for pagination.
array
Defines fields to return. Example: [“name”, “color”, “due_on”]
boolean
Provides “pretty” output.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Number of results to return per page.
string
Offset token to request next page.
array
Fields to include in response. Common fields: archived, color, created_at, current_status_update, due_on, members, name, notes, owner, start_on, team, workspace.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PORTFOLIO_MEMBERSHIPGet a portfolio membership. Requires an Asana plan with Portfolios access.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
portfolio_membership_gid

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
A string identifying a user. This can either be the string “me”, an email, or the GID of a user.
integer
Results per page. The number of objects to return per page. Must be between 1 and 100, inclusive.
string
Offset token. An offset to paginate from. This can be retrieved from the ‘next_page’ field in the previous response.
string
The GID of the portfolio to filter memberships on.
string
The GID of the workspace to filter memberships on.
array
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PORTFOLIO_MEMBERSHIPS_FOR_PORTFOLIOGet memberships from a portfolio. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.

Input Parameters

string
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PORTFOLIOSRetrieve portfolios in a specific workspace for a specified owner.

Input Parameters

integer
The number of objects to return per page. Must be between 1 and 100.
string
required
The user GID who owns the portfolio. Use ‘me’ to refer to the current authenticated user. This parameter is required by the Asana API.
string
An offset token for pagination.
string
required
The workspace or organization GID to filter portfolios on. Must be a non-empty numeric GID (e.g., ‘1205766922013215’).
array
Fields to include in the response. For example: [‘name’, ‘color’, ‘owner’].

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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
boolean
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.
string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_CUSTOM_FIELD_SETTINGSList the custom-field settings attached to an Asana project.

Input Parameters

integer
Maximum number of custom-field settings to return per page (1-100).
string
Opaque offset token returned by a previous page of results.
array
Documented fields to include in each custom-field setting representation.
boolean
Whether to return human-readable JSON with indentation and line breaks.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
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.
string
required
Globally unique identifier for the project membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_PORTFOLIO_SETTINGGet a project portfolio setting.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project portfolio setting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PORTFOLIOGet project portfolio settings for a portfolio. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana plan with Portfolios access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PROJECTGet project portfolio settings for a project. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECTS_FOR_TASKList projects associated with a specific task. Results are paginated, with a next-page token when available.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
The task to operate on.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token. An offset to the next page returned by the API.
boolean
Only return projects whose archived field takes on the value of this parameter.
string
required
Globally unique identifier for the team. Must be a numeric string (digits only).
array
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.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_STATUSRetrieve a project status update by its GID.

Input Parameters

array
Fields to include in the response.
boolean
Provides “pretty” output.
string
required
Globally unique identifier for the project status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token. An offset to paginate from. This can be retrieved from the ‘next_page’ field in a previous response.
array
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.
boolean
Provides “pretty” output. Adds indentation and newlines to the response. This can be useful when debugging but increases the response size.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_PROJECT_TEMPLATEGet a single Asana project template, including configuration needed to instantiate it.

Input Parameters

array
Fields to include in the response, including nested fields such as requested_roles.name or team.name.
boolean
Return indented JSON for debugging; increases response size.
string
required
Globally unique identifier for the project template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
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.
array
A comma-separated list of fields to include in the response. For example: name,description,owner,team,public
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the team.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_RATEGet a rate.

Input Parameters

string
required
Globally unique identifier for the rate.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_RATESGet multiple rates. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
Globally unique identifier for project.
string
Globally unique identifier for user or placeholder.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.
string
required
Only return reactions with this emoji base character.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_ROLEGet a role.

Input Parameters

string
required
Globally unique identifier for the role.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_ROLESGet multiple roles. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
boolean
Only return projects whose archived field takes on the value of this parameter.
string
required
The workspace or organization to filter roles on.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
Provides “pretty” output.
string
required
The globally unique identifier for the section.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_SECTIONS_IN_PROJECTList compact section records for a specified project. Results are paginated, but the response does not include a next-page token.

Input Parameters

integer
Number of sections to return per page (1-100).
string
Token for pagination to retrieve the next page of results.
string
required
Globally unique identifier (GID) of the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
Provides “pretty” output. Provides the response in a “pretty” format with proper line breaking and indentation.
string
required
Globally unique identifier for the status update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
The maximum number of items to return per page. The value must be between 1 and 100.
string
An offset token returned from a previous query that had a next_page property. This is used for pagination.
string
required
Globally unique identifier (GID) of the object (project, portfolio, or goal) from which to fetch status updates.
array
A comma-separated list of fields to include in the response. This allows customization of the returned data.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_STORIES_FOR_GOALGet stories from a goal. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
Only return stories created after this time. Applies to every story type; pair it with resource_subtype=comment_added to get just the comments added since a given moment. The bound is exclusive but has second granularity: it is truncated to the start of its second before filtering, so any story created within that same second is still returned. A client polling with the created_at of the last story it saw should expect to see that story again, and others alongside it, and should de-duplicate on gid.
boolean
Creation-time order: true (the default) is oldest first, false is newest first. Pair false with limit to read only the most recent stories. Ordering is applied across the parent’s stories; on a parent with an extremely large activity feed the feed may be truncated before it is ordered, so pair false with created_after to bound what is considered.
string
Only return stories of this subtype. Only comment_added is supported, which narrows the response to comments and excludes activity such as assignments, due date changes, and project moves. Omit to return the full activity feed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of results per page (between 1 and 100).
string
Offset token for pagination.
string
required
The GID of the task to get stories from.
array
A comma-separated list of optional properties to include in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_STORYRetrieve a single story by its GID, with optional selection of response fields.

Input Parameters

string
required
Globally unique identifier for the story.
array
A comma-separated list of fields to include in the response.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Globally unique identifier for the tag.
array
A comma-separated list of properties to include in the response.
boolean
If true, provides “pretty” (i.e., human-readable) JSON output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TAGSGet multiple tags in a workspace.

Input Parameters

integer
Results per page.
string
Offset token for pagination.
string
The GID of the workspace to filter tags on.
array
Comma-separated list of optional properties to include in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TAGS_FOR_TASKGet a page of tags associated with a specific task, with pagination support.

Input Parameters

integer
Results per page. The value must be between 1 and 100.
string
Offset token for pagination. An offset to the next page returned by the API.
string
required
Globally unique identifier for the task.
array
A comma-separated list of properties to include in the response.
boolean
If true, provides “pretty” (i.e., human-readable) JSON output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TAGS_FOR_WORKSPACEGet a page of tags in a specific workspace, with pagination support.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
The number of results per page.
string
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.
array
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.
string
required
The GID of the task, project, or project_brief to fetch attachments from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TASK_FOR_CUSTOM_IDGet a task for a given custom ID.

Input Parameters

string
required
Generated custom ID for a task.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the tag.
array
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’).
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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.
boolean
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.
string
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’.
string
required
Globally unique identifier (GID) of the user task list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TASKS_FROM_A_PROJECTRetrieves tasks from a specified Asana project, with a completion-since filter and optional field selection. Returned task details are limited to the tool’s response fields.

Input Parameters

integer
Maximum number of tasks to return per page. Defaults to 100 to enable pagination and avoid API errors on large projects.
string
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.
array
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.
boolean
If true, returns human-readable JSON; useful for debugging but increases response size.
string
required
Globally unique identifier (GID) of the project.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Maximum number of tasks to return per page (1-100).
string
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.
array
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.
boolean
If true, returns human-readable JSON; useful for debugging but increases response size.
string
required
Globally unique identifier (GID) of the section.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TASK_SUBTASKSLists subtasks of a specified Asana task, with pagination and optional field selection.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
The globally unique identifier for the task.
array
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TASK_TEMPLATERetrieve a task template’s configuration by its GID, without instantiating it. Discover template GIDs by listing task templates for a project first.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the task template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TASK_TEMPLATESLists Asana task templates for a workspace or project, with pagination.

Input Parameters

integer
The number of objects to return per page.
string
Offset token for pagination.
string
Comma-separated list of fields to include in the response. For example: ‘name,created_at,created_by’.
string
Globally unique identifier for the project. One of project or workspace must be specified.
string
Globally unique identifier for the workspace. One of project or workspace must be specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Globally unique identifier for the team.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
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.
string
required
Globally unique identifier for the team membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
The team to filter memberships to.
string
A user gid to filter memberships to.
integer
Results per page.
string
Offset token.
string
The workspace to filter memberships to.
array
Defines fields to return.
boolean
Adds indentation to JSON response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the team.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TEAM_MEMBERSHIPS_FOR_USERRetrieve a page of team memberships for a specific user within a workspace. Pagination information can be used to retrieve further results.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
string
required
Globally unique identifier for the workspace.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TEAMS_FOR_USERGet a page of team records for a specific user in an organization or workspace. Pagination information can be used to retrieve further results.

Input Parameters

integer
Results per page. The value must be between 1 and 100.
string
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.
string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
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.
string
required
The workspace or organization to filter teams on.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TEAMS_IN_WORKSPACERetrieve a page of compact team records in a workspace visible to the authorized user.

Input Parameters

integer
Results per page. The value must be between 1 and 100.
string
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.
string
required
The Global ID (GID) of the workspace to get teams from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
Comma-separated list of fields to include in the response.
boolean
Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable.
string
required
Globally unique identifier for the time period.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page.
string
The last day of the time period, YYYY-MM-DD.
string
Offset token for pagination.
string
The first day of the time period, YYYY-MM-DD.
array
A comma-separated list of fields to include in the response.
boolean
Provides the response in “pretty” output.
string
required
Globally unique identifier for the workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIMESHEET_APPROVAL_STATUSGet a timesheet approval status.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the timesheet approval status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIMESHEET_APPROVAL_STATUSESGet multiple timesheet approval statuses. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

string
Globally unique identifier for the user to filter timesheet approval statuses by.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
The end date for filtering timesheet approval statuses.
string
The start date for filtering timesheet approval statuses.
string
required
Globally unique identifier for the workspace.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
Filter by approval status. Can be one or more of draft, submitted, approved, or rejected.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIME_TRACKING_CATEGORIESGet time tracking categories for a workspace. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
Globally unique identifier for the workspace.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
boolean
Filter by archived status. If not provided, defaults to returning non-archived categories.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIME_TRACKING_CATEGORYGet a time tracking category.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the time tracking category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
Globally unique identifier for the task to filter time tracking entries by.
string
Globally unique identifier for the user to filter time tracking entries by.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
Globally unique identifier for the portfolio to filter time tracking entries by.
string
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.
array
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.
boolean
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.
string
Globally unique identifier for the project the time tracking entries are attributed to.
string
The end date for filtering time tracking entries by when they were entered.
string
The start date for filtering time tracking entries by when they were entered.
string
Globally unique identifier for the timesheet approval status to filter time tracking entries by.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
The task to operate on.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TIME_TRACKING_CATEGORYGet time tracking entries for a time tracking category. Returns one page; pass next_page.offset with the same filters to continue.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
The end date for filtering time tracking entries by their entry date.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
The start date for filtering time tracking entries by their entry date.
string
required
Globally unique identifier for the time tracking category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_TIME_TRACKING_ENTRYGet a time tracking entry.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the time tracking entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

integer
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.
string
The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.
array
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.
boolean
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.
string ("custom_field" | "goal" | "project" | "project_template" | "portfolio" | "tag" | "task" | "team" | "user")
The type of values the typeahead should return.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_USERGet a user by their ID.

Input Parameters

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_USERS_FOR_TEAMGet users in a team.

Input Parameters

integer
Results per page. The maximum is 2000.
string
Offset token.
string
required
Globally unique identifier for the team.
array
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.
boolean
Provides “pretty” output.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_USERS_FOR_WORKSPACEGet users in a workspace or organization.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token for pagination requests.
array
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.
boolean
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
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.
string
required
Globally unique identifier for the user task list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_WEBHOOKGet a webhook.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the webhook.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_WEBHOOKSRetrieve a page of webhooks in a workspace, optionally filtered by resource. Use the returned pagination information to retrieve additional pages.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token for pagination. An offset to the next page returned by the API.
string
Only return webhooks for the given resource.
string
required
The workspace to query for webhooks in.
array
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.
boolean
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
This results in a compact response, suitable for data-transfer sensitive applications. Valid values are: gid, name, resource_type, email_domains, is_organization.
boolean
Provides “pretty” output. Formatting dates and times as human-readable strings, numbers as strings, and including newlines and indentation. The default value is false.
string
required
The globally unique identifier of the workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_WORKSPACE_EVENTSGet one page of workspace events since a sync token was created. Omit sync initially. A missing or expired token returns a fresh sync token as a successful continuation response. Call again with that token to read events. Each page is limited to 1000 events; while has_more is true, call again with the returned sync token. Requires a service account with Workspace Events access in an Enterprise+ domain or an Enterprise domain with the Compliance Management Add-on.

Input Parameters

string
A sync token received from the last request, or none on first sync. Events will be returned from the point in time that the sync token was generated. Note: On your first request, omit the sync token. The response will be the same as for an expired sync token, and will include a new valid sync token. If the sync token is too old (which may happen from time to time) the API will return a 412 Precondition Failed error, and include a fresh sync token in the response.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

array
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.
boolean
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.
string
required
Globally unique identifier for the workspace membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
Offset token.
array
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.
string
required
Globally unique identifier for the workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_WORKSPACE_MEMBERSHIPS_FOR_USERRetrieve a page of workspace memberships for a specific user. Use the returned pagination information to retrieve additional pages.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_GET_WORKSPACE_PROJECTSRetrieve a page of projects associated with a specific Asana workspace. Use the returned pagination information to retrieve additional pages.

Input Parameters

integer
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.
string
Offset token for pagination.
array
Fields to expand in the response.
array
Fields to include in the response.
string
required
Globally unique identifier for the workspace.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The data for the enum option to be inserted or reordered.
array
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.
boolean
Provides “pretty” output.
string
required
Globally unique identifier for the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The data specifying which section to move and where to position it.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The name for the new project that will be created from the template.
string
Globally unique identifier for the team that the new project will belong to. Required if the template is a team template.
boolean
If true, requires all date and role variables from the template to be provided. If false or omitted, missing variables will use defaults.
array
Optional fields to include in the response. Common values: gid, status, new_project, new_project_template.
boolean
If true, returns human-readable JSON response (for debugging only due to size/processing impact).
string ("public_to_workspace" | "private_to_team" | "private")
Privacy setting for the new project. If not specified, inherits from template or team settings.
array
Array of date variable assignments. Required if the template includes date variables and is_strict is true.
array
Array of role assignments mapping template roles to specific users.
string
required
Globally unique identifier for the project template to instantiate.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_INSTANTIATE_TASK_TEMPLATEInstantiate a task from a task template.

Input Parameters

object
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the task template.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_LIST_GOAL_RELATIONSHIPSGet goal relationships. Returns one page; pass next_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.

Input Parameters

integer
Results per page. The number of objects to return per page. The value must be between 1 and 100.
string
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.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the supported goal in the goal relationship.
string
If provided, filter to goal relationships with a given resource_subtype.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_LIST_TASK_DEPENDENCIESList the prerequisite tasks that must be completed before an Asana task.

Input Parameters

integer
Maximum number of dependencies to return per page (1-100).
string
Opaque offset token returned by a previous page of results.
string
required
Globally unique identifier for the dependent task.
array
Fields to include in each dependency task representation.
boolean
Whether to return human-readable JSON with indentation and line breaks.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_LIST_TASK_DEPENDENTSList tasks that are blocked by a specified Asana task.

Input Parameters

integer
The number of dependents to return per page, from 1 to 100.
string
The opaque offset token returned in next_page.offset for the next page.
string
required
The globally unique identifier for the task whose dependents should be listed.
array
Fields to include for each dependent task. They are sent to Asana as a comma-separated list.
boolean
Whether Asana should format the JSON response for human readability.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
Globally unique identifier for the access request to reject. Must be a numeric string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_GOALRemove a custom field from a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
Data
string
required
Globally unique identifier for the goal.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PORTFOLIORemove a custom field from a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
Data
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PROJECTRemove a custom field from a project.

Input Parameters

object
required
Data
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the task.
array
required
An array of user GIDs to remove as followers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
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”.
array
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.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_FOLLOWERS_FROM_GOALRemove a collaborator from a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
Data
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier (GID) of the item (project or portfolio) to remove from the portfolio.
string
Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
boolean
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.
string
required
The globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_MEMBERS_FOR_PORTFOLIORemove users from a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A comma-separated string of user identifiers. These can be the string “me”, an email, or the gid of a user.
array
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.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The project to remove the task from.
string
required
The task to operate on.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_SUPPORTING_RELATIONSHIPRemoves a supporting goal relationship. Requires an Asana subscription with Goals access.

Input Parameters

object
required
Data
string
required
Globally unique identifier for the goal.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The globally unique identifier for the tag to remove from the task.
string
required
The globally unique identifier for the task.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_TASK_DEPENDENCIESTool to unlink selected prerequisite relationships from an Asana task without deleting any task.

Input Parameters

string
required
The globally unique identifier for the task whose dependency relationships will be removed.
boolean
Provides ‘pretty’ output with line breaks and indentation. This takes extra time and increases the response size, so it is advisable only during debugging.
array
required
An array of task GIDs to unlink as prerequisites of the target task. The tasks themselves are not deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_REMOVE_TASK_DEPENDENTSUnlink selected dependent tasks from an Asana prerequisite task without deleting any task.

Input Parameters

string
required
The GID of the prerequisite task whose dependent relationships will be removed.
array
required
Task GIDs to unlink as dependents of this task. The tasks themselves are not deleted.
boolean
Pretty-print the JSON response. Adds time and response size; use only for debugging.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string ‘me’, an email, or the gid of a user.
string
required
Globally unique identifier for the team.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ROLLUP_PROJECTStart a background job to reconcile subtask dates in a project. Poll Get Job with the returned job gid to check completion.

Input Parameters

array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_ROLLUP_TASKStart a background job to reconcile a task’s subtask dates. Poll Get Job with the returned job gid to check completion.

Input Parameters

string
required
The task to operate on.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_SAVE_PROJECT_AS_TEMPLATECreate a project template from a project.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_SEARCH_PROJECTS_FOR_WORKSPACESearch projects in a workspace.

Input Parameters

string
Performs full-text search on the project name.
integer
Results per search response. The number of objects to return in one search response. The value must be between 1 and 100. Search responses have no next_page, so to retrieve further results, sort by created_at and repeat the query with a created_at.before or created_at.after filter that excludes the results you have already seen.
string
ISO 8601 date string or null.
string ("due_date" | "created_at" | "completed_at" | "modified_at" | "relevance")
One of due_date, created_at, completed_at, relevance, or modified_at, defaults to modified_at.
string
ISO 8601 date string or null.
boolean
Filter on project completion status.
string
Comma-separated list of user identifiers to filter on as project owners. This can either be the string “me”, an email, or the gid of a user.
string
Comma-separated list of team IDs.
string
ISO 8601 date string or null.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
Comma-separated list of user identifiers to filter on as members. This can either be the string “me”, an email, or the gid of a user.
string
Comma-separated list of user identifiers to exclude as members. This can either be the string “me”, an email, or the gid of a user.
string
ISO 8601 date string or null.
string
ISO 8601 datetime string.
string
ISO 8601 date string.
string
ISO 8601 datetime string.
string
ISO 8601 date string.
string
required
Globally unique identifier for the workspace or organization.
string
Comma-separated list of portfolio IDs to filter on.
boolean
Default false.
string
ISO 8601 date string.
string
ISO 8601 date string.
string
ISO 8601 datetime string.
string
ISO 8601 date string.
string
ISO 8601 datetime string.
string
ISO 8601 date string.
string
ISO 8601 datetime string.
string
ISO 8601 date string.
string
ISO 8601 datetime string.
string
ISO 8601 date string.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_SEARCH_TASKS_IN_WORKSPACESearch tasks in an Asana workspace by project, assignee, task subtype or text, with optional result fields and a limit of 1–100. When the plan does not provide workspace search, filtering is reduced: text and combined project and assignee filters are not fully applied.

Input Parameters

string
Search for tasks containing this text in name or notes. At least one search filter must be provided.
integer
Maximum number of results to return (1-100).
array
Additional fields to include in each task object; see Asana API docs for available fields.
boolean
Pretty-print the JSON response with indentation (useful for debugging).
array
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.
array
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.
string
required
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.
string
Filter by task subtype: ‘default_task’ for regular tasks, ‘milestone’ for milestones. At least one search filter must be provided.
string
Message explaining any automatic modifications made to the request.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
The GID of the new parent task, or ‘null’ to remove the parent. Setting a parent makes this task a subtask of the parent.
string
required
The globally unique identifier (GID) of the task to set the parent for.
string
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.
boolean
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.
string
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.
string
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_SUBMIT_PARALLEL_REQUESTSSubmit up to 10 Asana API requests in parallel using the Batch API, such as fetching multiple tasks or creating multiple subtasks. Results include individual action status codes and bodies.

Input Parameters

object
required
Contains the list of actions to be performed in parallel.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_TRIGGER_RULETrigger a rule. Runs the configured rule and may trigger external side effects; use only a rule you intend to run.

Input Parameters

object
required
Data
string
required
The ID of the incoming web request trigger. This value is a path parameter that is automatically generated for the API endpoint.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The data to update the allocation with.
array
A comma-separated list of fields to include in the response.
boolean
If true, the response will be in a human-readable format.
string
required
Globally unique identifier for the allocation to be updated.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_A_TASKUpdates attributes of an existing Asana task identified by its task_gid.

Input Parameters

object
required
An object containing the fields of the task to update.
string
required
The GID of the task to update.
array
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.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_BUDGETUpdate a budget.

Input Parameters

object
required
A budget object represents a budget for a given parent.
string
required
Globally unique identifier for the budget.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_CUSTOM_FIELDUpdate the name or description of a custom field by its globally unique identifier.

Input Parameters

object
required
The data to update the custom field with.
array
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.
boolean
Provides “pretty” output.
string
required
Globally unique identifier for the custom field.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
The data to update the enum option with.
array
Defines the fields to be returned in the response.
boolean
Provides “pretty” output. Formatting of the result will follow JSON pretty print conventions (line breaks and indentation).
string
required
Globally unique identifier for the enum option.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_GOALUpdate a goal. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_GOAL_METRICUpdate a goal metric. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
string
required
Globally unique identifier for the goal.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_GOAL_RELATIONSHIPUpdate a goal relationship. Requires an Asana subscription with Goals access.

Input Parameters

object
required
A goal relationship is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the goal relationship.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_MEMBERSHIPUpdate a membership.

Input Parameters

object
required
Data
boolean
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.
string
required
Globally unique identifier for the membership.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_OOO_ENTRYUpdate an OOO entry.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the OOO entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_PORTFOLIOUpdate a portfolio. Requires an Asana plan with Portfolios access.

Input Parameters

object
required
A portfolio gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent project status update. Portfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the portfolio.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_PROJECTUpdate a project.

Input Parameters

string
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.
string
The GID of the team that this project is shared with.
string
Color of the project.
string
Free-form textual information associated with the project (its description).
string
The GID of the new owner of the project. May be null.
string
The day on which this project is due. This takes a date with format YYYY-MM-DD.
boolean
True if the project is public to its team.
boolean
True if the project is archived, false if not.
string
The localized day on which this project is due. This takes a date with format YYYY-MM-DD.
string
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.
string
Opt In. The notes of the project with formatting as HTML.
boolean
Opt In. True if the project is a template.
string
required
The GID of the project to update.
string
The default view (list, board, calendar, or timeline) of a project.
object
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
The plain text content of the project brief. This field updates the main content/description of the project brief.
array
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
boolean
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.
string
required
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_PROJECT_PORTFOLIO_SETTINGUpdate a project portfolio setting.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the project portfolio setting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_RATEUpdate a rate.

Input Parameters

object
required
A generic Asana Resource, containing a globally unique identifier.
string
required
Globally unique identifier for the rate.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_ROLEUpdate a role.

Input Parameters

object
required
A role represents a group of permissions that can be assigned to a user or team.
string
required
Globally unique identifier for the role.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
The new name for the section. This is the text displayed as the section header. Cannot be an empty string.
array
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.
boolean
Provides ‘pretty’ output with proper line breaking and indentation. Advisable only during debugging as it increases response time and size.
string
required
The globally unique identifier for the section to update.
string
An existing section within this project after which the section should be inserted. Cannot be provided together with insert_before.
string
An existing section within this project before which the section should be inserted. Cannot be provided together with insert_after.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
An object containing the fields of the story to update.
string
required
Globally unique identifier for the story.
array
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.
boolean
Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

object
required
An object containing the fields to update.
string
required
The globally unique identifier for the tag.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
The new name of the team.
string
required
Globally unique identifier for the team.
array
Defines fields to return.
boolean
Provides “pretty” output.
string
The new description of the team.
string
GID of the organization to which the team belongs. This is the GID of an organization, not its name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_TIMESHEET_APPROVAL_STATUSUpdate a timesheet approval status.

Input Parameters

object
required
A request to update a timesheet approval status.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the timesheet approval status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_TIME_TRACKING_CATEGORYUpdate a time tracking category.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the time tracking category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_TIME_TRACKING_ENTRYUpdate a time tracking entry.

Input Parameters

object
required
Data
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the time tracking entry.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
string
The workspace to filter results on.
array
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.
boolean
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.
object
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: 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

string
required
A string identifying a user. This can either be the string “me”, an email, or the gid of a user.
array
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.
boolean
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
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_WEBHOOKUpdate an existing Asana webhook’s event filter configuration. At least one non-empty filter is required.

Input Parameters

array
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
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’.
boolean
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.
string
required
Globally unique identifier for the webhook to update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: ASANA_UPDATE_WORKSPACEUpdate a workspace.

Input Parameters

object
required
A workspace is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.
array
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. Properties can include nested fields. To learn more, see the input/output options guide.
boolean
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.
string
required
Globally unique identifier for the workspace or organization.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: ASANA_TASK_ATTACHMENT_ADDEDType: webhookTriggers when an attachment is added to a task.

Configuration

string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.

Payload

string
required
GID of the attachment
string
Subtype of the attachment (e.g. ‘external’)
string
required
Timestamp of the event
string
required
GID of the task the attachment was added to
string
GID of the user who added the attachment
Slug: ASANA_TASK_COMMENT_ADDEDType: webhookTriggers when a comment is added to a task in a project.

Configuration

string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.

Payload

string
required
Timestamp of the event
string
required
GID of the comment story
string
required
GID of the task the comment was added to
string
GID of the user who posted the comment
Slug: ASANA_TASK_CREATEDType: webhookTriggers when a new task is created in a project.

Configuration

string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.

Payload

string
required
Timestamp of the event
string
required
GID of the project the task was added to
string
required
GID of the created task
string
GID of the user who created the task
Slug: ASANA_TASK_MOVED_TO_SECTIONType: webhookTriggers when a task is moved to a section in a project.

Configuration

string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.
string
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

string
required
Timestamp of the event
string
required
GID of the destination section
string
required
GID of the task that was moved
string
GID of the user who moved the task
Slug: ASANA_TASK_TAG_ADDEDType: webhookTriggers when a tag is added to a task.Note: Asana’s event structure is inverted for tag events — the resource is the task and the parent is the tag. So parent.gid gives the tag GID.

Configuration

string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.
string
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

string
required
Timestamp of the event
string
required
GID of the tag that was added
string
required
GID of the task the tag was added to
string
GID of the user who added the tag
Slug: ASANA_TASK_UPDATEDType: webhookTriggers when a task is updated in a project.

Configuration

array
Only trigger when one of these fields changes (e.g. [‘assignee’, ‘due_on’, ‘name’]). If not set, triggers on any field change.
string
required
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/&#123;project_gid&#125;/…). Must be a GID — project names are not accepted.

Payload

string
required
The change action (e.g. ‘changed’)
string
required
Name of the field that changed
string
required
Timestamp of the event
object
New value of the field, if available
string
required
GID of the updated task
string
GID of the user who made the change