> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Asana

> Tool to help teams organize, track, and manage their work.

![Asana logo](https://mintcdn.com/composio-preview/6S5R4NszqpnVIZRD/images/toolkits/asana.svg?fit=max\&auto=format\&n=6S5R4NszqpnVIZRD\&q=85\&s=ee4571898fef60afdf2d0cfff189db05)

* **Category:** project management
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 157
* **Triggers:** 6
* **Slug:** `ASANA`
* **Version:** 20261101\_00

## Frequently Asked Questions

> [accordion] How do I set up custom OAuth credentials for Asana?
>
> 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](https://composio.dev/auth/asana).

## Tools

> [accordion] Add a custom field to a goal
>
> **Slug:** `ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_GOAL`
>
> Add a custom field to a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a custom field to a portfolio
>
> **Slug:** `ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PORTFOLIO`
>
> Add a custom field to a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a custom field to a project
>
> **Slug:** `ASANA_ADD_CUSTOM_FIELD_SETTING_FOR_PROJECT`
>
> Add a custom field to a project.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add a collaborator to a goal
>
> **Slug:** `ASANA_ADD_FOLLOWERS_TO_GOAL`
>
> Add a collaborator to a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Followers to Project
>
> **Slug:** `ASANA_ADD_FOLLOWERS_TO_PROJECT`
>
> Tool to add followers to a project in Asana. Use this tool when you need to add one or more users as followers to a specific project. Followers will receive notifications when tasks are added to the project.
>
> #### Input Parameters
>
> **followers** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Followers to Task
>
> **Slug:** `ASANA_ADD_FOLLOWERS_TO_TASK`
>
> Tool to add followers to a task in Asana. Use this tool when you need to add one or more users as followers to a specific task. This will notify them of updates to the task.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task.
>
> **followers** `array` *required*
>
> An array of user GIDs to add as followers to the task. For example: \["12345", "67890"].
>
> **opt\_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. For example \["followers", "assignee"].
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add item to portfolio
>
> **Slug:** `ASANA_ADD_ITEM_TO_PORTFOLIO`
>
> Add 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
>
> **item** `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.
>
> **insert\_after** `string`
>
> GID of a portfolio item after which to insert the new item. Mutually exclusive with `insert_before`.
>
> **insert\_before** `string`
>
> GID of a portfolio item before which to insert the new item. Mutually exclusive with `insert_after`.
>
> **portfolio\_gid** `string` *required*
>
> The globally unique identifier (GID) of the portfolio to add the item to. Must be a numeric string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add users to a portfolio
>
> **Slug:** `ASANA_ADD_MEMBERS_FOR_PORTFOLIO`
>
> Add users to a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Members to Project
>
> **Slug:** `ASANA_ADD_MEMBERS_TO_PROJECT`
>
> Tool to add users to a project in Asana. Use this tool when you need to add one or more users as members to a specific project. Members can view and contribute to the project.
>
> #### Input Parameters
>
> **members** `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](mailto:user@example.com)".
>
> **opt\_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. For example: \["members", "name", "archived"].
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Project to Task
>
> **Slug:** `ASANA_ADD_PROJECT_FOR_TASK`
>
> Tool to add a project to a task in Asana. Use when you need to associate a task with a project. Optionally position the task within the project using insert\_before, insert\_after, or section parameters.
>
> #### Input Parameters
>
> **project** `string` *required*
>
> The globally unique identifier for the project to add to the task.
>
> **section** `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.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task to add a project to.
>
> **opt\_pretty** `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.
>
> **insert\_after** `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.
>
> **insert\_before** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Supporting Relationship to Goal
>
> **Slug:** `ASANA_ADD_SUPPORTING_RELATIONSHIP`
>
> Tool to add a supporting goal relationship to a goal. Use when you want to link a project, task, portfolio, or another goal as a supporting resource to a specific goal in Asana.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The request data for adding a supporting relationship.
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Tag to Task
>
> **Slug:** `ASANA_ADD_TAG_TO_TASK`
>
> Tool to add an existing tag to a task in Asana. Use when you need to add a tag for prioritization, routing, or automation workflows. Tags cannot be added via Update Task, so this dedicated endpoint is required.
>
> #### Input Parameters
>
> **tag\_gid** `string` *required*
>
> The globally unique identifier for the tag to add. The tag must already exist in the workspace.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task.
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Task Dependencies
>
> **Slug:** `ASANA_ADD_TASK_DEPENDENCIES`
>
> Tool to add dependency relationships to an Asana task. Use when you need to mark one or more tasks as prerequisites (dependencies) for another task, ensuring the dependency tasks must be completed first.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task that will depend on other tasks.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **dependencies** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add Task Dependents
>
> **Slug:** `ASANA_ADD_TASK_DEPENDENTS`
>
> Mark 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
>
> **task\_gid** `string` *required*
>
> The globally unique identifier of the prerequisite task to operate on.
>
> **dependents** `array` *required*
>
> Task GIDs to mark as dependents of this task. These tasks depend on the target task, not the reverse.
>
> **opt\_pretty** `boolean`
>
> Pretty-print the response with line breaks and indentation. This increases response size and processing time; use only for debugging.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add task to section
>
> **Slug:** `ASANA_ADD_TASK_TO_SECTION`
>
> Adds an existing task to a section, optionally positioning it before or after another task in that section; if no position is specified, the task is added to the end.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The GID of the existing task to add to the section. Must be a numeric string.
>
> **section\_gid** `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.
>
> **insert\_after** `string`
>
> GID of a task in the section after which to insert the current task. Mutually exclusive with insert\_before.
>
> **insert\_before** `string`
>
> GID of a task in the section before which to insert the current task. Mutually exclusive with insert\_after.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add User for Team
>
> **Slug:** `ASANA_ADD_USER_TO_TEAM`
>
> Tool to add a user to a team in Asana. Use this when you need to add a user to a specific team by providing their user GID, email, or "me" for the current user.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Add User for Workspace
>
> **Slug:** `ASANA_ADD_USER_TO_WORKSPACE`
>
> Tool to add a user to a workspace or organization in Asana. Use this when you need to add a user to a specific workspace by providing their user GID, email, or "me" for the current user.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Approve Access Request
>
> **Slug:** `ASANA_APPROVE_ACCESS_REQUEST`
>
> Tool to approve an access request in Asana. Use when you need to grant access to a resource that requires approval workflow.
>
> #### Input Parameters
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response.
>
> **opt\_pretty** `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.
>
> **access\_request\_gid** `string` *required*
>
> Globally unique identifier for the access request to approve.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Access Request
>
> **Slug:** `ASANA_CREATE_ACCESS_REQUEST`
>
> Tool to create an access request in Asana. Use when you need to request access to a project or portfolio that you don't currently have access to.
>
> #### Input Parameters
>
> **target** `string` *required*
>
> The globally unique identifier (gid) of the access requestable object that the user is requesting access to. Supports projects and portfolios.
>
> **message** `string`
>
> The optional message to include with the access request. This can be used to provide context or additional information about the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Allocation
>
> **Slug:** `ASANA_CREATE_ALLOCATION`
>
> Creates 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
>
> **notes** `string`
>
> Any additional notes related to the allocation.
>
> **end\_on** `string` *required*
>
> The end date of the allocation. The format is YYYY-MM-DD.
>
> **start\_on** `string` *required*
>
> The start date of the allocation. The format is YYYY-MM-DD.
>
> **effort\_type** `string ("hours" | "percent")` *required*
>
> The unit type for tracking effort on the allocation. Must be either 'hours' or 'percent'.
>
> **project\_gid** `string`
>
> The project GID for which this allocation is being made. If provided, the allocation will be linked to this project.
>
> **assignee\_gid** `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.
>
> **effort\_value** `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'.
>
> **workspace\_gid** `string` *required*
>
> The ID of the workspace where the allocation will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a project
>
> **Slug:** `ASANA_CREATE_A_PROJECT`
>
> Creates a new Asana project in the specified workspace. Requires a `workspace` GID, and additionally a `team` GID if the workspace is an organization.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data payload for the new project.
>
> **opt\_fields** `array`
>
> Array of optional properties to include in the response.
>
> **opt\_pretty** `boolean`
>
> True for human-readable JSON response (debugging only due to size/processing).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a tag in a workspace
>
> **Slug:** `ASANA_CREATE_A_TAG_IN_A_WORKSPACE`
>
> Creates a new tag, with properties like name and color defined in the request body, within a specific Asana workspace (using `workspace_gid`); this tag helps categorize tasks, is confined to the workspace, and is not automatically applied to tasks.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The properties for the tag creation, including name (required), color (optional), and notes (optional).
>
> **opt\_fields** `array`
>
> List of fields from `OptFieldsEnm0` (e.g., 'name', 'color') to include in the response; returns a compact representation by default.
>
> **opt\_pretty** `boolean`
>
> If true, pretty-prints the JSON response; useful for debugging but may increase response size.
>
> **workspace\_gid** `string` *required*
>
> The globally unique identifier (GID) for the workspace or organization in which to create the tag.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create task in asana with specific details
>
> **Slug:** `ASANA_CREATE_A_TASK`
>
> Creates a new Asana task; requires 'workspace', 'parent', or 'projects' for association, and 'followers', 'projects', 'tags' are set only at creation.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Task details for creation.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' JSON output with line breaks/indentation. Useful for debugging; may increase response time/size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Attachment for Object
>
> **Slug:** `ASANA_CREATE_ATTACHMENT_FOR_OBJECT`
>
> Tool 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
>
> **url** `string`
>
> The URL of the external resource being attached. Required for attachments of type 'external'. Mutually exclusive with 'file'.
>
> **file** `object`
>
> Required for 'asana' attachments. This field should be provided when uploading a file. Mutually exclusive with 'url'.
>
> **name** `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.
>
> **parent** `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.
>
> **connect\_to\_app** `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.
>
> **resource\_subtype** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Attachment for Task
>
> **Slug:** `ASANA_CREATE_ATTACHMENT_FOR_TASK`
>
> Tool to upload an attachment to a task. Use when you need to attach a file to a specific task in Asana.
>
> #### Input Parameters
>
> **file** `object` *required*
>
> The file to upload.
>
> **parent\_gid** `string` *required*
>
> Globally unique identifier for the parent task or comment.
>
> **connect\_to\_app** `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.
>
> **resource\_subtype** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a budget
>
> **Slug:** `ASANA_CREATE_BUDGET`
>
> Create a budget.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *budget* object represents a budget for a given parent.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Custom Field
>
> **Slug:** `ASANA_CREATE_CUSTOM_FIELD`
>
> Tool to create a new custom field in a workspace. Use when you need to define a new field for tracking specific information within Asana tasks.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The custom field object to create.
>
> **opt\_fields** `array`
>
> Comma-separated list of properties to include in the response.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Enum Option for Custom Field
>
> **Slug:** `ASANA_CREATE_ENUM_OPTION_FOR_CUSTOM_FIELD`
>
> Tool 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
>
> **data** `object` *required*
>
> The enum option to create.
>
> **opt\_fields** `array`
>
> Defines fields to return.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **custom\_field\_gid** `string` *required*
>
> Globally unique identifier for the custom field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a goal
>
> **Slug:** `ASANA_CREATE_GOAL`
>
> Create a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a goal metric
>
> **Slug:** `ASANA_CREATE_GOAL_METRIC`
>
> Create a goal metric. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Membership
>
> **Slug:** `ASANA_CREATE_MEMBERSHIP`
>
> Tool to create a membership by adding a user or team to a project, goal, or portfolio. Use when you need to grant access to an Asana resource.
>
> #### Input Parameters
>
> **role** `string`
>
> Role of the member in the parent resource. This is an optional parameter.
>
> **member** `string` *required*
>
> GID of the member (user or team) to add to the parent resource. Must be a numeric GID string (e.g., '1210124065021206').
>
> **parent** `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').
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' output with proper line breaking and indentation for debugging. May increase response size.
>
> **access\_level** `string`
>
> Access level for the member in the parent resource. Common values: 'admin', 'editor', 'commenter', 'viewer'. Defaults to 'editor' if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create an OOO entry
>
> **Slug:** `ASANA_CREATE_OOO_ENTRY`
>
> Create an OOO entry.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a portfolio
>
> **Slug:** `ASANA_CREATE_PORTFOLIO`
>
> Create a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project Brief
>
> **Slug:** `ASANA_CREATE_PROJECT_BRIEF`
>
> Tool to create a project brief for a project. Use when you need to add a detailed explanation (what and why) to a project.
>
> #### Input Parameters
>
> **html\_text** `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>'.
>
> **opt\_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. Available options: html\_text, permalink\_url, project, project.name, text, title
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create project for team
>
> **Slug:** `ASANA_CREATE_PROJECT_FOR_TEAM`
>
> Tool to create a project in a team. Use when you need to create a new project within a specific Asana team.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Project data payload containing the project details to create.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team. This is the team where the project will be created.
>
> **opt\_fields** `array`
>
> Array of optional field names to include in the response (e.g., 'name', 'notes', 'owner', 'workspace.name'). By default, some properties are excluded.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create project for workspace
>
> **Slug:** `ASANA_CREATE_PROJECT_FOR_WORKSPACE`
>
> Tool to create a project in a workspace. Use when you need to create a new project within a specific Asana workspace. Note: The team field is required when creating projects in workspaces.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Project data payload containing the project details to create.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' output with proper line breaking and indentation for debugging. Note: increases response size and processing time.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization where the project will be created.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Project Status Update
>
> **Slug:** `ASANA_CREATE_PROJECT_STATUS_UPDATE`
>
> Tool to create a new status update on a project. Use when you need to communicate the current status, progress, or any blockers related to a specific project.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> The HTML content of the status update.
>
> **color** `string ("GREEN" | "YELLOW" | "RED" | "BLUE" | "COMPLETE")` *required*
>
> Color of the status update. Supported values: GREEN, YELLOW, RED, BLUE, COMPLETE.
>
> **title** `string` *required*
>
> The title of the project status update.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> **status\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a rate
>
> **Slug:** `ASANA_CREATE_RATE`
>
> Create a rate.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a role
>
> **Slug:** `ASANA_CREATE_ROLE`
>
> Create a role.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *role* represents a group of permissions that can be assigned to a user or team.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a section in a project
>
> **Slug:** `ASANA_CREATE_SECTION_IN_PROJECT`
>
> Creates a new SECTION (not a task) in a project. Sections are organizational containers within a project used to group and categorize tasks (e.g., 'To Do', 'In Progress', 'Done', 'Backlog'). The new section can be optionally positioned relative to an existing section in the same project. IMPORTANT: This action creates SECTIONS only. Do NOT use this action to create tasks. To create a task, use the ASANA\_CREATE\_A\_TASK action instead. Task-related fields like 'assignee', 'notes', 'due\_date', 'description' are NOT supported by this action.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Name for the new section. This is a section name (e.g., 'To Do', 'In Progress'), NOT a task name.
>
> **project\_gid** `string` *required*
>
> GID of the project where the section will be created. Must be a valid project GID.
>
> **insert\_after** `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.
>
> **insert\_before** `string`
>
> GID of an existing section to insert the new section before; if omitted, the new section is added at the end.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Status Update for Object
>
> **Slug:** `ASANA_CREATE_STATUS_FOR_OBJECT`
>
> Tool 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
>
> **text** `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.
>
> **title** `string`
>
> The title of the status update. If not provided, Asana may auto-generate a title based on the status\_type.
>
> **parent** `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').
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' JSON output with line breaks and indentation. Useful for debugging; may increase response time and size.
>
> **status\_type** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a story on a goal
>
> **Slug:** `ASANA_CREATE_STORY_FOR_GOAL`
>
> Create a story on a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A story represents an activity associated with an object in the Asana system.
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create subtask
>
> **Slug:** `ASANA_CREATE_SUBTASK`
>
> Creates a new Asana subtask under an existing parent task (`task_gid`); `due_on` and `due_at` are mutually exclusive and cannot be set simultaneously.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the subtask to be created.
>
> **notes** `string`
>
> Optional descriptive text for the subtask.
>
> **due\_at** `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`.
>
> **due\_on** `string`
>
> Optional due date for the subtask in YYYY-MM-DD format, representing the end of the day for the task.
>
> **assignee** `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.
>
> **task\_gid** `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.
>
> **completed** `boolean`
>
> Optional flag to mark the subtask as completed upon creation. Defaults to false if not specified.
>
> **followers** `array`
>
> Optional array of user Global IDs (GIDs) to add as followers to the subtask. Followers receive notifications about subtask updates.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a tag
>
> **Slug:** `ASANA_CREATE_TAG`
>
> Tool 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
>
> **data** `object` *required*
>
> The properties for the tag to be created.
>
> **opt\_fields** `array`
>
> List of field names to include in the response. Common fields: color, created\_at, followers, name, notes, permalink\_url, workspace.
>
> **opt\_pretty** `boolean`
>
> If true, provides pretty-printed JSON response. Useful for debugging but may increase response size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create task comment
>
> **Slug:** `ASANA_CREATE_TASK_COMMENT`
>
> Adds a new text comment (story) to an existing Asana task, appearing in its activity feed.
>
> #### Input Parameters
>
> **text** `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.
>
> **task\_id** `string` *required*
>
> The globally unique identifier (GID) of the Asana task to which the comment will be added.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Team
>
> **Slug:** `ASANA_CREATE_TEAM`
>
> Creates a new team in a specified Asana organization for collaboration.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The request data for creating a team.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a timesheet approval status
>
> **Slug:** `ASANA_CREATE_TIMESHEET_APPROVAL_STATUS`
>
> Create a timesheet approval status.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A request to create a timesheet approval status.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a time tracking category
>
> **Slug:** `ASANA_CREATE_TIME_TRACKING_CATEGORY`
>
> Create a time tracking category.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a time tracking entry
>
> **Slug:** `ASANA_CREATE_TIME_TRACKING_ENTRY`
>
> Create a time tracking entry.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **task\_gid** `string` *required*
>
> The task to operate on.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Allocation
>
> **Slug:** `ASANA_DELETE_ALLOCATION`
>
> Tool to delete an allocation by its ID. Use this when you need to remove a specific resource allocation in Asana.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **allocation\_gid** `string` *required*
>
> Globally unique identifier for the allocation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Attachment
>
> **Slug:** `ASANA_DELETE_ATTACHMENT`
>
> Tool to delete an attachment by its globally unique identifier. Use when you need to remove an existing attachment from Asana.
>
> #### Input Parameters
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **attachment\_gid** `string` *required*
>
> Globally unique identifier for the attachment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a budget
>
> **Slug:** `ASANA_DELETE_BUDGET`
>
> Delete a budget.
>
> #### Input Parameters
>
> **budget\_gid** `string` *required*
>
> Globally unique identifier for the budget.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Custom Field
>
> **Slug:** `ASANA_DELETE_CUSTOM_FIELD`
>
> Tool to delete a custom field by its globally unique identifier. Use when you need to remove an existing custom field from Asana.
>
> #### Input Parameters
>
> **custom\_field\_gid** `string` *required*
>
> Globally unique identifier for the custom field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a goal
>
> **Slug:** `ASANA_DELETE_GOAL`
>
> Delete a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Membership
>
> **Slug:** `ASANA_DELETE_MEMBERSHIP`
>
> Tool to delete a membership by its GID. Use this when you need to remove a user or team's access to a project, portfolio, goal, or custom field in Asana.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **membership\_gid** `string` *required*
>
> Globally unique identifier for the membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete an OOO entry
>
> **Slug:** `ASANA_DELETE_OOO_ENTRY`
>
> Delete an OOO entry.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **ooo\_entry\_gid** `string` *required*
>
> Globally unique identifier for the OOO entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a portfolio
>
> **Slug:** `ASANA_DELETE_PORTFOLIO`
>
> Delete a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a project
>
> **Slug:** `ASANA_DELETE_PROJECT`
>
> Delete a project.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Project Brief
>
> **Slug:** `ASANA_DELETE_PROJECT_BRIEF`
>
> Tool 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
>
> **opt\_pretty** `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.
>
> **project\_brief\_gid** `string` *required*
>
> Globally unique identifier for the project brief to delete. Must be a numeric string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Project Status
>
> **Slug:** `ASANA_DELETE_PROJECT_STATUS`
>
> Tool to delete a project status by its GID. Use when you need to remove a specific project status update from Asana.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **project\_status\_gid** `string` *required*
>
> Globally unique identifier for the project status to delete. Must be a numeric string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a project template
>
> **Slug:** `ASANA_DELETE_PROJECT_TEMPLATE`
>
> Delete a project template.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **project\_template\_gid** `string` *required*
>
> Globally unique identifier for the project template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a rate
>
> **Slug:** `ASANA_DELETE_RATE`
>
> Delete a rate.
>
> #### Input Parameters
>
> **rate\_gid** `string` *required*
>
> Globally unique identifier for the rate.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a role
>
> **Slug:** `ASANA_DELETE_ROLE`
>
> Delete a role.
>
> #### Input Parameters
>
> **role\_gid** `string` *required*
>
> Globally unique identifier for the role.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a section
>
> **Slug:** `ASANA_DELETE_SECTION`
>
> Tool to delete a section by its GID. Use when you need to permanently remove a section from a project.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **section\_gid** `string` *required*
>
> The globally unique identifier for the section to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Status Update
>
> **Slug:** `ASANA_DELETE_STATUS_UPDATE`
>
> Tool to delete a status update by its GID. Use when you need to remove a specific status update from Asana.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **status\_update\_gid** `string` *required*
>
> Globally unique identifier for the status update to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Story
>
> **Slug:** `ASANA_DELETE_STORY`
>
> Tool to delete a story by its GID. Use when you need to remove a story from Asana.
>
> #### Input Parameters
>
> **story\_gid** `string` *required*
>
> Globally unique identifier for the story.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a Tag
>
> **Slug:** `ASANA_DELETE_TAG`
>
> Tool to delete a specific tag by its GID. Use when you need to remove an existing tag from Asana.
>
> #### Input Parameters
>
> **tag\_gid** `string` *required*
>
> The globally unique identifier for the tag.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a task
>
> **Slug:** `ASANA_DELETE_TASK`
>
> Delete a task.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> Globally unique identifier for the task to delete. Must be a numeric string.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a task template
>
> **Slug:** `ASANA_DELETE_TASK_TEMPLATE`
>
> Delete a task template.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **task\_template\_gid** `string` *required*
>
> Globally unique identifier for the task template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a time tracking category
>
> **Slug:** `ASANA_DELETE_TIME_TRACKING_CATEGORY`
>
> Delete a time tracking category.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **time\_tracking\_category\_gid** `string` *required*
>
> Globally unique identifier for the time tracking category.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a time tracking entry
>
> **Slug:** `ASANA_DELETE_TIME_TRACKING_ENTRY`
>
> Delete a time tracking entry.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **time\_tracking\_entry\_gid** `string` *required*
>
> Globally unique identifier for the time tracking entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete a webhook
>
> **Slug:** `ASANA_DELETE_WEBHOOK`
>
> Delete a webhook.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **webhook\_gid** `string` *required*
>
> Globally unique identifier for the webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Duplicate a portfolio
>
> **Slug:** `ASANA_DUPLICATE_PORTFOLIO`
>
> Duplicate a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `object`
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Duplicate Project
>
> **Slug:** `ASANA_DUPLICATE_PROJECT`
>
> Duplicate a project with a new name. Returns a duplication job and details of the new project.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> The name of the new project.
>
> **team** `string`
>
> Globally unique identifier for the team that the new project will belong to.
>
> **include** `array`
>
> A list of elements to be included in the duplication.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project to be duplicated.
>
> **schedule\_dates** `object`
>
> Scheduling information for the new project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Duplicate Task
>
> **Slug:** `ASANA_DUPLICATE_TASK`
>
> Duplicate a task, returning an asynchronous job record. Optionally specify the new task name and properties to copy.
>
> #### Input Parameters
>
> **name** `string`
>
> The name of the new task.
>
> **include** `array`
>
> List of properties to copy from the original task.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task to be duplicated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Access Requests
>
> **Slug:** `ASANA_GET_ACCESS_REQUESTS`
>
> Tool to retrieve access requests for a target object. Use when you need to get pending access requests for a specific resource like a project or portfolio.
>
> #### Input Parameters
>
> **user** `string`
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **target** `string` *required*
>
> Globally unique identifier for the target object.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get AI Studio credit utilization
>
> **Slug:** `ASANA_GET_AI_STUDIO_RUNS`
>
> Get AI Studio credit utilization. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **end\_at** `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.
>
> **offset** `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.*
>
> **start\_at** `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.
>
> **division\_gid** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get AI Studio seats
>
> **Slug:** `ASANA_GET_AI_STUDIO_SEATS`
>
> Get AI Studio seats. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **state** `string ("active" | "revoked")`
>
> Filter seats to this state.
>
> **offset** `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.*
>
> **division\_gid** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Allocation
>
> **Slug:** `ASANA_GET_ALLOCATION`
>
> Get an allocation by ID. Use when you need to retrieve the details of a specific allocation.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **allocation\_gid** `string` *required*
>
> Globally unique identifier for the allocation.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Allocations
>
> **Slug:** `ASANA_GET_ALLOCATIONS`
>
> Tool to get multiple allocations. Requires either 'parent' (project GID) OR both 'assignee' AND 'workspace' together.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page.
>
> **offset** `string`
>
> Offset token.
>
> **parent** `string`
>
> Globally unique identifier for the project to filter allocations by. Required if 'assignee' and 'workspace' are not both provided.
>
> **assignee** `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.
>
> **workspace** `string`
>
> Globally unique identifier for the workspace. Must be provided together with 'assignee' if 'parent' is not specified.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a project
>
> **Slug:** `ASANA_GET_A_PROJECT`
>
> Retrieves 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
>
> **opt\_fields** `array`
>
> Defines a comma-separated list of optional fields for a more detailed project representation in the response, beyond the default compact view.
>
> **opt\_pretty** `boolean`
>
> Pretty-prints the JSON response for readability, useful for debugging.
>
> **project\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a task
>
> **Slug:** `ASANA_GET_A_TASK`
>
> Retrieves full details for a specified task GID accessible by the user; use `opt_fields` to customize returned data.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> Globally unique identifier (GID) of the task.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> If true, formats JSON response with indentation for readability; for debugging, as it increases response size/time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Attachment
>
> **Slug:** `ASANA_GET_ATTACHMENT`
>
> Tool 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
>
> **opt\_fields** `string`
>
> A comma-separated list of fields to include in the response. For example: "name,size,url".
>
> **attachment\_gid** `string` *required*
>
> The globally unique identifier for the attachment.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Audit Log Events
>
> **Slug:** `ASANA_GET_AUDIT_LOG_EVENTS`
>
> Retrieve audit log events for a workspace or organization, with optional filters. Asana requires a service account for audit log access.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **end\_at** `string`
>
> Filter to events created before this time (exclusive).
>
> **offset** `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.
>
> **start\_at** `string`
>
> Filter to events created after this time (inclusive).
>
> **actor\_gid** `string`
>
> Filter to events triggered by the actor with this ID.
>
> **actor\_type** `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.
>
> **event\_type** `string`
>
> Filter to events of this type. Refer to the supported audit log events for a full list of values.
>
> **resource\_gid** `string`
>
> Filter to events with this resource ID.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a user task list
>
> **Slug:** `ASANA_GET_A_USER_TASK_LIST`
>
> Retrieves 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
>
> **workspace** `string` *required*
>
> The GID of the workspace to filter the user task list.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **user\_task\_list\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a budget
>
> **Slug:** `ASANA_GET_BUDGET`
>
> Get a budget.
>
> #### Input Parameters
>
> **budget\_gid** `string` *required*
>
> Globally unique identifier for the budget.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get all budgets
>
> **Slug:** `ASANA_GET_BUDGETS`
>
> Get all budgets.
>
> #### Input Parameters
>
> **parent** `string` *required*
>
> Globally unique identifier for the budget's parent object. This currently can only be a `project`.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user
>
> **Slug:** `ASANA_GET_CURRENT_USER`
>
> Retrieve the authenticated user, including accessible workspaces, for establishing user context.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Field
>
> **Slug:** `ASANA_GET_CUSTOM_FIELD`
>
> Retrieve a custom field by its globally unique identifier, with optional selection of returned properties.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **custom\_field\_gid** `string` *required*
>
> Globally unique identifier for the custom field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a goal's custom fields
>
> **Slug:** `ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_GOAL`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a portfolio's custom fields
>
> **Slug:** `ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_PORTFOLIO`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a team's custom fields
>
> **Slug:** `ASANA_GET_CUSTOM_FIELD_SETTINGS_FOR_TEAM`
>
> Get a team's custom fields.
>
> #### Input Parameters
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Fields for Workspace
>
> **Slug:** `ASANA_GET_CUSTOM_FIELDS_FOR_WORKSPACE`
>
> List custom fields in a workspace, returning a page of results and pagination information when available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a custom type
>
> **Slug:** `ASANA_GET_CUSTOM_TYPE`
>
> Get a custom type.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **custom\_type\_gid** `string` *required*
>
> Globally unique identifier for the custom type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Custom Types
>
> **Slug:** `ASANA_GET_CUSTOM_TYPES`
>
> List custom types associated with a project, returning a page of results and pagination information when available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **project** `string` *required*
>
> Globally unique identifier for the project, which is used as a filter when retrieving all custom types.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Events on a Resource
>
> **Slug:** `ASANA_GET_EVENTS`
>
> Retrieve 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
>
> **sync** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **resource\_gid** `string` *required*
>
> Globally unique identifier for the resource.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Favorites for User
>
> **Slug:** `ASANA_GET_FAVORITES_FOR_USER`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **workspace** `string` *required*
>
> The workspace in which to get favorites.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **resource\_type** `string ("portfolio" | "project" | "tag" | "task" | "user" | "project_template")`
>
> The resource type of favorites to be returned.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Goal
>
> **Slug:** `ASANA_GET_GOAL`
>
> Retrieve a single goal by its GID, with optional field selection.
>
> #### Input Parameters
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response. Example: "name,notes,due\_on"
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a goal relationship
>
> **Slug:** `ASANA_GET_GOAL_RELATIONSHIP`
>
> Get a goal relationship. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **goal\_relationship\_gid** `string` *required*
>
> Globally unique identifier for the goal relationship.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Goal Relationships
>
> **Slug:** `ASANA_GET_GOAL_RELATIONSHIPS`
>
> Tool to retrieve goal relationships. Use when you need to get the relationships associated with a specific goal in Asana.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The number of objects to return per page.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **goal\_gid** `string` *required*
>
> The globally unique identifier for the goal.
>
> **opt\_fields** `array`
>
> Defines fields to return.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Goals
>
> **Slug:** `ASANA_GET_GOALS`
>
> Tool 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
>
> **team** `string`
>
> Globally unique identifier for the team. Exactly one of workspace, team, portfolio, or project must be specified.
>
> **limit** `integer`
>
> The number of results to return.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **project** `string`
>
> Globally unique identifier for the project. Exactly one of workspace, team, portfolio, or project must be specified.
>
> **archived** `boolean`
>
> Filter to archived goals.
>
> **portfolio** `string`
>
> Globally unique identifier for the portfolio. Exactly one of workspace, team, portfolio, or project must be specified.
>
> **workspace** `string`
>
> Globally unique identifier for the workspace or organization. Exactly one of workspace, team, portfolio, or project must be specified.
>
> **opt\_fields** `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.
>
> **time\_period** `string`
>
> Globally unique identifier for the time period.
>
> **is\_workspace\_level** `boolean`
>
> Filter to goals at the workspace level.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Job
>
> **Slug:** `ASANA_GET_JOB`
>
> Tool to retrieve a job by its globally unique identifier. Use when you need to check the status of asynchronous operations like task duplication, project instantiation, or exports.
>
> #### Input Parameters
>
> **job\_gid** `string` *required*
>
> Globally unique identifier for the job.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Membership
>
> **Slug:** `ASANA_GET_MEMBERSHIP`
>
> Tool to retrieve a single membership by its ID. Use this when you need to get details about a specific membership relationship between a user/team and a goal, project, portfolio, or custom field.
>
> #### Input Parameters
>
> **opt\_pretty** `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.
>
> **membership\_gid** `string` *required*
>
> Globally unique identifier for the membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Memberships
>
> **Slug:** `ASANA_GET_MEMBERSHIPS`
>
> Tool 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
>
> **limit** `integer`
>
> The number of results to return per page.
>
> **member** `string`
>
> GID of the member (user or team) to filter memberships.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **parent** `string`
>
> GID of the parent resource (e.g., project\_gid, goal\_gid, portfolio\_gid, or custom\_field\_gid) to filter memberships.
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response (e.g., "parent,member,access\_level,parent.name,member.name").
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple projects
>
> **Slug:** `ASANA_GET_MULTIPLE_PROJECTS`
>
> Returns a list of projects filtered by workspace or team (one required), with optional archived status filter, supporting pagination for large datasets.
>
> #### Input Parameters
>
> **team** `string`
>
> GID of the team to filter projects by. Either workspace OR team is REQUIRED. GIDs are numeric strings (digits only, e.g., '1205029116228052').
>
> **limit** `integer`
>
> Number of projects to return per page (1-100).
>
> **offset** `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.
>
> **archived** `boolean`
>
> Filter projects by archived status: `True` for archived only, `False` for unarchived only.
>
> **workspace** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Return JSON in a 'pretty' format (indented, line breaks). For debugging only due to increased response size/time.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple tasks
>
> **Slug:** `ASANA_GET_MULTIPLE_TASKS`
>
> Retrieve 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
>
> **tag** `string`
>
> Tag GID to filter tasks. Mutually exclusive with project, section, user\_task\_list, or assignee+workspace.
>
> **limit** `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.
>
> **offset** `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).
>
> **project** `string`
>
> Project GID to filter tasks. Mutually exclusive with section, tag, user\_task\_list, or assignee+workspace.
>
> **section** `string`
>
> Section GID to filter tasks. Mutually exclusive with project, tag, user\_task\_list, or assignee+workspace.
>
> **assignee** `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).
>
> **workspace** `string`
>
> Workspace GID. Must be used with `assignee`. Mutually exclusive with project, section, tag, or user\_task\_list.
>
> **opt\_fields** `array`
>
> Optional fields to include. Use 'projects' (plural) for project data. See OptFieldsEnm0 for valid values.
>
> **opt\_pretty** `boolean`
>
> Format JSON output with indentation for debugging (may increase response time/size).
>
> **modified\_since** `string`
>
> ISO 8601 date-time. Returns tasks modified since this time (includes property/association changes).
>
> **user\_task\_list** `string`
>
> User task list GID to filter tasks. Mutually exclusive with project, section, tag, or assignee+workspace.
>
> **completed\_since** `string`
>
> Filter for tasks incomplete or completed since this ISO 8601 date-time or 'now'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple users
>
> **Slug:** `ASANA_GET_MULTIPLE_USERS`
>
> Returns a list of users in an Asana workspace or organization, optionally filtered by workspace or team GID, with support for pagination and specifying optional fields.
>
> #### Input Parameters
>
> **team** `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.
>
> **limit** `integer`
>
> The maximum number of user objects to return per page (1-100).
>
> **offset** `string`
>
> Opaque token for pagination to retrieve the subsequent page of results.
>
> **workspace** `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.
>
> **opt\_fields** `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'.
>
> **opt\_pretty** `boolean`
>
> Return the response in a human-readable JSON format.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple workspaces
>
> **Slug:** `ASANA_GET_MULTIPLE_WORKSPACES`
>
> Retrieve workspaces accessible to the authenticated user, with pagination support.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of workspace objects to return per page. Must be an integer between 1 and 100, inclusive.
>
> **offset** `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.
>
> **opt\_fields** `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'.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get OOO Entries
>
> **Slug:** `ASANA_GET_OOO_ENTRIES`
>
> Get 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
>
> **user** `string` *required*
>
> Globally unique identifier for the user to filter OOO entries by.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **end\_date** `string`
>
> An ISO 8601 date string. Filters to OOO entries that overlap with or start before this date.
>
> **workspace** `string` *required*
>
> Globally unique identifier for the workspace.
>
> **opt\_fields** `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](https://developers.asana.com/docs/inputoutput-options#selecting-nested-fields).
>
> **opt\_pretty** `boolean`
>
> Pretty-print the JSON response for debugging.
>
> **start\_date** `string`
>
> An ISO 8601 date string. Filters to OOO entries that overlap with or end after this date.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get an OOO entry
>
> **Slug:** `ASANA_GET_OOO_ENTRY`
>
> Get an OOO entry.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **ooo\_entry\_gid** `string` *required*
>
> Globally unique identifier for the OOO entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get parent goals from a goal
>
> **Slug:** `ASANA_GET_PARENT_GOALS_FOR_GOAL`
>
> Get parent goals from a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Portfolio
>
> **Slug:** `ASANA_GET_PORTFOLIO`
>
> Retrieve a single portfolio by its GID, with optional fields for portfolio details.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. Max 100.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **opt\_fields** `array`
>
> Defines fields to return. Example: \["name", "color", "due\_on"]
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Portfolio Items
>
> **Slug:** `ASANA_GET_PORTFOLIO_ITEMS`
>
> Retrieve items in a portfolio. Use this to get a list of projects or other portfolios contained within a specific portfolio.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of results to return per page.
>
> **offset** `string`
>
> Offset token to request next page.
>
> **opt\_fields** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a portfolio membership
>
> **Slug:** `ASANA_GET_PORTFOLIO_MEMBERSHIP`
>
> Get a portfolio membership. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_membership\_gid** `string` *required*
>
> portfolio\_membership\_gid
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Portfolio Memberships
>
> **Slug:** `ASANA_GET_PORTFOLIO_MEMBERSHIPS`
>
> Tool to retrieve multiple portfolio memberships. Use this tool when you need to list memberships for a specific portfolio, a user within a portfolio, or a user across all portfolios in a workspace.
>
> #### Input Parameters
>
> **user** `string`
>
> A string identifying a user. This can either be the string "me", an email, or the GID of a user.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. Must be between 1 and 100, inclusive.
>
> **offset** `string`
>
> Offset token. An offset to paginate from. This can be retrieved from the ‘next\_page’ field in the previous response.
>
> **portfolio** `string`
>
> The GID of the portfolio to filter memberships on.
>
> **workspace** `string`
>
> The GID of the workspace to filter memberships on.
>
> **opt\_fields** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get memberships from a portfolio
>
> **Slug:** `ASANA_GET_PORTFOLIO_MEMBERSHIPS_FOR_PORTFOLIO`
>
> Get 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
>
> **user** `string`
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Portfolios
>
> **Slug:** `ASANA_GET_PORTFOLIOS`
>
> Retrieve portfolios in a specific workspace for a specified owner.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The number of objects to return per page. Must be between 1 and 100.
>
> **owner** `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.
>
> **offset** `string`
>
> An offset token for pagination.
>
> **workspace** `string` *required*
>
> The workspace or organization GID to filter portfolios on. Must be a non-empty numeric GID (e.g., '1205766922013215').
>
> **opt\_fields** `array`
>
> Fields to include in the response. For example: \['name', 'color', 'owner'].
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Brief
>
> **Slug:** `ASANA_GET_PROJECT_BRIEF`
>
> Tool to retrieve a project brief by its GID. Use when you need to get the detailed explanation (what and why) of a project. 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
>
> **opt\_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. Available options: text
>
> **opt\_pretty** `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.
>
> **project\_brief\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Custom Field Settings
>
> **Slug:** `ASANA_GET_PROJECT_CUSTOM_FIELD_SETTINGS`
>
> List the custom-field settings attached to an Asana project.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of custom-field settings to return per page (1-100).
>
> **offset** `string`
>
> Opaque offset token returned by a previous page of results.
>
> **opt\_fields** `array`
>
> Documented fields to include in each custom-field setting representation.
>
> **opt\_pretty** `boolean`
>
> Whether to return human-readable JSON with indentation and line breaks.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Membership
>
> **Slug:** `ASANA_GET_PROJECT_MEMBERSHIP`
>
> Tool to get a project membership by ID. Use when you need to retrieve details of a specific project membership.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_membership\_gid** `string` *required*
>
> Globally unique identifier for the project membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Memberships For Project
>
> **Slug:** `ASANA_GET_PROJECT_MEMBERSHIPS`
>
> Tool to get memberships from a specific project. Use when you need to see who has access to a project and their permission levels.
>
> #### Input Parameters
>
> **user** `string`
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a project portfolio setting
>
> **Slug:** `ASANA_GET_PROJECT_PORTFOLIO_SETTING`
>
> Get a project portfolio setting.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_portfolio\_setting\_gid** `string` *required*
>
> Globally unique identifier for the project portfolio setting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project portfolio settings for a portfolio
>
> **Slug:** `ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PORTFOLIO`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get project portfolio settings for a project
>
> **Slug:** `ASANA_GET_PROJECT_PORTFOLIO_SETTINGS_FOR_PROJECT`
>
> Get project portfolio settings for a project. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Projects for Task
>
> **Slug:** `ASANA_GET_PROJECTS_FOR_TASK`
>
> List projects associated with a specific task. Results are paginated, with a next-page token when available.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **task\_gid** `string` *required*
>
> The task to operate on.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Projects for Team
>
> **Slug:** `ASANA_GET_PROJECTS_FOR_TEAM`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token. An offset to the next page returned by the API.
>
> **archived** `boolean`
>
> Only return projects whose `archived` field takes on the value of this parameter.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team. Must be a numeric string (digits only).
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Status
>
> **Slug:** `ASANA_GET_PROJECT_STATUS`
>
> Retrieve a project status update by its GID.
>
> #### Input Parameters
>
> **opt\_fields** `array`
>
> Fields to include in the response.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **project\_status\_gid** `string` *required*
>
> Globally unique identifier for the project status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Status Updates
>
> **Slug:** `ASANA_GET_PROJECT_STATUS_UPDATES`
>
> Tool to get status updates for a specific project. Use when you need to retrieve the latest or historical status reports associated with an Asana project.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token. An offset to paginate from. This can be retrieved from the 'next\_page' field in a previous response.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output. Adds indentation and newlines to the response. This can be useful when debugging but increases the response size.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Template
>
> **Slug:** `ASANA_GET_PROJECT_TEMPLATE`
>
> Get a single Asana project template, including configuration needed to instantiate it.
>
> #### Input Parameters
>
> **opt\_fields** `array`
>
> Fields to include in the response, including nested fields such as requested\_roles.name or team.name.
>
> **opt\_pretty** `boolean`
>
> Return indented JSON for debugging; increases response size.
>
> **project\_template\_gid** `string` *required*
>
> Globally unique identifier for the project template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Multiple Project Templates
>
> **Slug:** `ASANA_GET_PROJECT_TEMPLATES`
>
> Tool to retrieve multiple project templates. Use when you need to list available project templates in a workspace or team.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **team\_gid** `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.
>
> **opt\_fields** `array`
>
> A comma-separated list of fields to include in the response. For example: name,description,owner,team,public
>
> **workspace\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Project Templates for Team
>
> **Slug:** `ASANA_GET_PROJECT_TEMPLATES_FOR_TEAM`
>
> Tool to get a team's project templates in Asana. Use when you need to retrieve project templates associated with a specific team.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a rate
>
> **Slug:** `ASANA_GET_RATE`
>
> Get a rate.
>
> #### Input Parameters
>
> **rate\_gid** `string` *required*
>
> Globally unique identifier for the rate.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple rates
>
> **Slug:** `ASANA_GET_RATES`
>
> Get multiple rates. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **parent** `string`
>
> Globally unique identifier for `project`.
>
> **resource** `string`
>
> Globally unique identifier for `user` or `placeholder`.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Reactions on Object
>
> **Slug:** `ASANA_GET_REACTIONS_ON_OBJECT`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **target** `string` *required*
>
> Globally unique identifier for object to fetch reactions from. Must be a GID for a status update or story.
>
> **emoji\_base** `string` *required*
>
> Only return reactions with this emoji base character.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a role
>
> **Slug:** `ASANA_GET_ROLE`
>
> Get a role.
>
> #### Input Parameters
>
> **role\_gid** `string` *required*
>
> Globally unique identifier for the role.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple roles
>
> **Slug:** `ASANA_GET_ROLES`
>
> Get multiple roles. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **archived** `boolean`
>
> Only return projects whose `archived` field takes on the value of this parameter.
>
> **workspace** `string` *required*
>
> The workspace or organization to filter roles on.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Section
>
> **Slug:** `ASANA_GET_SECTION`
>
> Retrieve the full record for a single section by its GID. Use this when you need to get details about a specific section within a project.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **section\_gid** `string` *required*
>
> The globally unique identifier for the section.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get sections in a project
>
> **Slug:** `ASANA_GET_SECTIONS_IN_PROJECT`
>
> List compact section records for a specified project. Results are paginated, but the response does not include a next-page token.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Number of sections to return per page (1-100).
>
> **offset** `string`
>
> Token for pagination to retrieve the next page of results.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier (GID) of the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Status Update
>
> **Slug:** `ASANA_GET_STATUS`
>
> Tool 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
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides "pretty" output. Provides the response in a "pretty" format with proper line breaking and indentation.
>
> **status\_update\_gid** `string` *required*
>
> Globally unique identifier for the status update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Status Updates
>
> **Slug:** `ASANA_GET_STATUS_UPDATES`
>
> Retrieve status updates from an object. Use when you need to get the latest or historical status updates for a specific project, portfolio, or goal.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The maximum number of items to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> An offset token returned from a previous query that had a `next_page` property. This is used for pagination.
>
> **parent** `string` *required*
>
> Globally unique identifier (GID) of the object (project, portfolio, or goal) from which to fetch status updates.
>
> **opt\_fields** `array`
>
> A comma-separated list of fields to include in the response. This allows customization of the returned data.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get stories from a goal
>
> **Slug:** `ASANA_GET_STORIES_FOR_GOAL`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **created\_after** `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`.
>
> **sort\_ascending** `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.
>
> **resource\_subtype** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Stories for Task
>
> **Slug:** `ASANA_GET_STORIES_FOR_TASK`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page. The number of results per page (between 1 and 100).
>
> **offset** `string`
>
> Offset token for pagination.
>
> **task\_gid** `string` *required*
>
> The GID of the task to get stories from.
>
> **opt\_fields** `array`
>
> A comma-separated list of optional properties to include in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Story
>
> **Slug:** `ASANA_GET_STORY`
>
> Retrieve a single story by its GID, with optional selection of response fields.
>
> #### Input Parameters
>
> **story\_gid** `string` *required*
>
> Globally unique identifier for the story.
>
> **opt\_fields** `array`
>
> A comma-separated list of fields to include in the response.
>
> **opt\_pretty** `boolean`
>
> Provides "pretty" output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tag
>
> **Slug:** `ASANA_GET_TAG`
>
> Tool to get a single tag by its globally unique identifier. Use when you need to retrieve detailed information about a specific tag.
>
> #### Input Parameters
>
> **tag\_gid** `string` *required*
>
> Globally unique identifier for the tag.
>
> **opt\_fields** `array`
>
> A comma-separated list of properties to include in the response.
>
> **opt\_pretty** `boolean`
>
> If true, provides "pretty" (i.e., human-readable) JSON output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tags
>
> **Slug:** `ASANA_GET_TAGS`
>
> Get multiple tags in a workspace.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **workspace** `string`
>
> The GID of the workspace to filter tags on.
>
> **opt\_fields** `array`
>
> Comma-separated list of optional properties to include in the response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tags for Task
>
> **Slug:** `ASANA_GET_TAGS_FOR_TASK`
>
> Get a page of tags associated with a specific task, with pagination support.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token for pagination. An offset to the next page returned by the API.
>
> **task\_gid** `string` *required*
>
> Globally unique identifier for the task.
>
> **opt\_fields** `array`
>
> A comma-separated list of properties to include in the response.
>
> **opt\_pretty** `boolean`
>
> If true, provides "pretty" (i.e., human-readable) JSON output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Tags For Workspace
>
> **Slug:** `ASANA_GET_TAGS_FOR_WORKSPACE`
>
> Get a page of tags in a specific workspace, with pagination support.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Attachments
>
> **Slug:** `ASANA_GET_TASK_ATTACHMENTS`
>
> Tool 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
>
> **limit** `integer`
>
> The number of results per page.
>
> **offset** `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.
>
> **opt\_fields** `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`.
>
> **parent\_gid** `string` *required*
>
> The GID of the task, project, or project\_brief to fetch attachments from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Counts For Project
>
> **Slug:** `ASANA_GET_TASK_COUNTS_FOR_PROJECT`
>
> Tool to get task count statistics for a project. Use when you need to retrieve the number of tasks, completed tasks, incomplete tasks, and milestone 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
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a task for a given custom ID
>
> **Slug:** `ASANA_GET_TASK_FOR_CUSTOM_ID`
>
> Get a task for a given custom ID.
>
> #### Input Parameters
>
> **custom\_id** `string` *required*
>
> Generated custom ID for a task.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get tasks for tag
>
> **Slug:** `ASANA_GET_TASKS_FOR_TAG`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **tag\_gid** `string` *required*
>
> Globally unique identifier for the tag.
>
> **opt\_fields** `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').
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get tasks for user task list
>
> **Slug:** `ASANA_GET_TASKS_FOR_USER_TASK_LIST`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **completed\_since** `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'.
>
> **user\_task\_list\_gid** `string` *required*
>
> Globally unique identifier (GID) of the user task list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Retrieve tasks for project
>
> **Slug:** `ASANA_GET_TASKS_FROM_A_PROJECT`
>
> Retrieves 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
>
> **limit** `integer`
>
> Maximum number of tasks to return per page. Defaults to 100 to enable pagination and avoid API errors on large projects.
>
> **offset** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> If true, returns human-readable JSON; useful for debugging but increases response size.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier (GID) of the project.
>
> **completed\_since** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get tasks from a section
>
> **Slug:** `ASANA_GET_TASKS_FROM_SECTION`
>
> Tool 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
>
> **limit** `integer`
>
> Maximum number of tasks to return per page (1-100).
>
> **offset** `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.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> If true, returns human-readable JSON; useful for debugging but increases response size.
>
> **section\_gid** `string` *required*
>
> Globally unique identifier (GID) of the section.
>
> **completed\_since** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Subtasks
>
> **Slug:** `ASANA_GET_TASK_SUBTASKS`
>
> Lists subtasks of a specified Asana task, with pagination and optional field selection.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task.
>
> **opt\_fields** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a task template
>
> **Slug:** `ASANA_GET_TASK_TEMPLATE`
>
> Retrieve a task template's configuration by its GID, without instantiating it. Discover template GIDs by listing task templates for a project first.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **task\_template\_gid** `string` *required*
>
> Globally unique identifier for the task template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Templates
>
> **Slug:** `ASANA_GET_TASK_TEMPLATES`
>
> Lists Asana task templates for a workspace or project, with pagination.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The number of objects to return per page.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response. For example: 'name,created\_at,created\_by'.
>
> **project\_gid** `string`
>
> Globally unique identifier for the project. One of project or workspace must be specified.
>
> **workspace\_gid** `string`
>
> Globally unique identifier for the workspace. One of project or workspace must be specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team
>
> **Slug:** `ASANA_GET_TEAM`
>
> Tool to retrieve details of a specific team by its GID. Use when you need to fetch information about a particular team in Asana.
>
> #### Input Parameters
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Membership
>
> **Slug:** `ASANA_GET_TEAM_MEMBERSHIP`
>
> Tool 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
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **team\_membership\_gid** `string` *required*
>
> Globally unique identifier for the team membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Memberships
>
> **Slug:** `ASANA_GET_TEAM_MEMBERSHIPS`
>
> Tool to retrieve compact team membership records. Use when you need to list members of a team, teams a user belongs to, or all team memberships in a workspace.
>
> #### Input Parameters
>
> **team** `string`
>
> The team to filter memberships to.
>
> **user** `string`
>
> A user gid to filter memberships to.
>
> **limit** `integer`
>
> Results per page.
>
> **offset** `string`
>
> Offset token.
>
> **workspace** `string`
>
> The workspace to filter memberships to.
>
> **opt\_fields** `array`
>
> Defines fields to return.
>
> **opt\_pretty** `boolean`
>
> Adds indentation to JSON response.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Memberships for Team
>
> **Slug:** `ASANA_GET_TEAM_MEMBERSHIPS_FOR_TEAM`
>
> Tool to get memberships from a specific team. Use when you need to retrieve the list of users who are members of a particular team, including their membership details such as admin status and guest status.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Team Memberships For User
>
> **Slug:** `ASANA_GET_TEAM_MEMBERSHIPS_FOR_USER`
>
> Retrieve a page of team memberships for a specific user within a workspace. Pagination information can be used to retrieve further results.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **workspace** `string` *required*
>
> Globally unique identifier for the workspace.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Teams for User
>
> **Slug:** `ASANA_GET_TEAMS_FOR_USER`
>
> Get 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
>
> **limit** `integer`
>
> Results per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **organization** `string` *required*
>
> The workspace or organization to filter teams on.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get teams in workspace
>
> **Slug:** `ASANA_GET_TEAMS_IN_WORKSPACE`
>
> Retrieve a page of compact team records in a workspace visible to the authorized user.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **workspace\_gid** `string` *required*
>
> The Global ID (GID) of the workspace to get teams from.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Period
>
> **Slug:** `ASANA_GET_TIME_PERIOD`
>
> Tool 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
>
> **opt\_fields** `array`
>
> Comma-separated list of fields to include in the response.
>
> **opt\_pretty** `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.
>
> **time\_period\_gid** `string` *required*
>
> Globally unique identifier for the time period.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Periods
>
> **Slug:** `ASANA_GET_TIME_PERIODS`
>
> Tool 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
>
> **limit** `integer`
>
> Results per page.
>
> **end\_on** `string`
>
> The last day of the time period, YYYY-MM-DD.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **start\_on** `string`
>
> The first day of the time period, YYYY-MM-DD.
>
> **opt\_fields** `array`
>
> A comma-separated list of fields to include in the response.
>
> **opt\_pretty** `boolean`
>
> Provides the response in "pretty" output.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a timesheet approval status
>
> **Slug:** `ASANA_GET_TIMESHEET_APPROVAL_STATUS`
>
> Get a timesheet approval status.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **timesheet\_approval\_status\_gid** `string` *required*
>
> Globally unique identifier for the timesheet approval status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get multiple timesheet approval statuses
>
> **Slug:** `ASANA_GET_TIMESHEET_APPROVAL_STATUSES`
>
> Get multiple timesheet approval statuses. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **user** `string`
>
> Globally unique identifier for the user to filter timesheet approval statuses by.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **to\_date** `string`
>
> The end date for filtering timesheet approval statuses.
>
> **from\_date** `string`
>
> The start date for filtering timesheet approval statuses.
>
> **workspace** `string` *required*
>
> Globally unique identifier for the workspace.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **approval\_statuses** `string`
>
> Filter by approval status. Can be one or more of draft, submitted, approved, or rejected.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get time tracking categories for a workspace
>
> **Slug:** `ASANA_GET_TIME_TRACKING_CATEGORIES`
>
> Get time tracking categories for a workspace. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **workspace** `string` *required*
>
> Globally unique identifier for the workspace.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **is\_archived** `boolean`
>
> Filter by archived status. If not provided, defaults to returning non-archived categories.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a time tracking category
>
> **Slug:** `ASANA_GET_TIME_TRACKING_CATEGORY`
>
> Get a time tracking category.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **time\_tracking\_category\_gid** `string` *required*
>
> Globally unique identifier for the time tracking category.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Tracking Entries
>
> **Slug:** `ASANA_GET_TIME_TRACKING_ENTRIES`
>
> Tool 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
>
> **task** `string`
>
> Globally unique identifier for the task to filter time tracking entries by.
>
> **user** `string`
>
> Globally unique identifier for the user to filter time tracking entries by.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **portfolio** `string`
>
> Globally unique identifier for the portfolio to filter time tracking entries by.
>
> **workspace** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **attributable\_to** `string`
>
> Globally unique identifier for the project the time tracking entries are attributed to.
>
> **entered\_on\_end\_date** `string`
>
> The end date for filtering time tracking entries by when they were entered.
>
> **entered\_on\_start\_date** `string`
>
> The start date for filtering time tracking entries by when they were entered.
>
> **timesheet\_approval\_status** `string`
>
> Globally unique identifier for the timesheet approval status to filter time tracking entries by.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Time Tracking Entries for Task
>
> **Slug:** `ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TASK`
>
> Tool to get time tracking entries for a task. Use when you need to retrieve time tracking information recorded on a specific task.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **task\_gid** `string` *required*
>
> The task to operate on.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get time tracking entries for a time tracking category
>
> **Slug:** `ASANA_GET_TIME_TRACKING_ENTRIES_FOR_TIME_TRACKING_CATEGORY`
>
> Get time tracking entries for a time tracking category. Returns one page; pass next\_page.offset with the same filters to continue.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **end\_date** `string`
>
> The end date for filtering time tracking entries by their entry date.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **start\_date** `string`
>
> The start date for filtering time tracking entries by their entry date.
>
> **time\_tracking\_category\_gid** `string` *required*
>
> Globally unique identifier for the time tracking category.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a time tracking entry
>
> **Slug:** `ASANA_GET_TIME_TRACKING_ENTRY`
>
> Get a time tracking entry.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **time\_tracking\_entry\_gid** `string` *required*
>
> Globally unique identifier for the time tracking entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Objects via Typeahead
>
> **Slug:** `ASANA_GET_TYPEAHEAD_OBJECTS`
>
> Tool 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
>
> **count** `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.
>
> **query** `string`
>
> The string that will be used to search for relevant objects. If an empty string is passed in, the API will return results.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **resource\_type** `string ("custom_field" | "goal" | "project" | "project_template" | "portfolio" | "tag" | "task" | "team" | "user")`
>
> The type of values the typeahead should return.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User
>
> **Slug:** `ASANA_GET_USER`
>
> Get a user by their ID.
>
> #### Input Parameters
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User in Workspace
>
> **Slug:** `ASANA_GET_USER_FOR_WORKSPACE`
>
> Tool 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
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Users for Team
>
> **Slug:** `ASANA_GET_USERS_FOR_TEAM`
>
> Get users in a team.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The maximum is 2000.
>
> **offset** `string`
>
> Offset token.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Users in Workspace
>
> **Slug:** `ASANA_GET_USERS_FOR_WORKSPACE`
>
> Get users in a workspace or organization.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token for pagination requests.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Task List
>
> **Slug:** `ASANA_GET_USER_TASK_LIST`
>
> Tool 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
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **user\_task\_list\_gid** `string` *required*
>
> Globally unique identifier for the user task list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get a webhook
>
> **Slug:** `ASANA_GET_WEBHOOK`
>
> Get a webhook.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **webhook\_gid** `string` *required*
>
> Globally unique identifier for the webhook.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Webhooks
>
> **Slug:** `ASANA_GET_WEBHOOKS`
>
> Retrieve a page of webhooks in a workspace, optionally filtered by resource. Use the returned pagination information to retrieve additional pages.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token for pagination. An offset to the next page returned by the API.
>
> **resource** `string`
>
> Only return webhooks for the given resource.
>
> **workspace** `string` *required*
>
> The workspace to query for webhooks in.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace
>
> **Slug:** `ASANA_GET_WORKSPACE`
>
> Tool to retrieve details of a specific workspace by its GID. Use when you need to get information about a particular Asana workspace.
>
> #### Input Parameters
>
> **opt\_fields** `array`
>
> This results in a compact response, suitable for data-transfer sensitive applications. Valid values are: gid, name, resource\_type, email\_domains, is\_organization.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> The globally unique identifier of the workspace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get workspace events
>
> **Slug:** `ASANA_GET_WORKSPACE_EVENTS`
>
> Get 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
>
> **sync** `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.*
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Membership
>
> **Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIP`
>
> Tool 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
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **workspace\_membership\_gid** `string` *required*
>
> Globally unique identifier for the workspace membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Memberships
>
> **Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIPS`
>
> Tool to retrieve the workspace memberships for a specific workspace. Use when you need to list members of a workspace.
>
> #### Input Parameters
>
> **user** `string`
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `string`
>
> Offset token.
>
> **opt\_fields** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Memberships For User
>
> **Slug:** `ASANA_GET_WORKSPACE_MEMBERSHIPS_FOR_USER`
>
> Retrieve a page of workspace memberships for a specific user. Use the returned pagination information to retrieve additional pages.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workspace Projects
>
> **Slug:** `ASANA_GET_WORKSPACE_PROJECTS`
>
> Retrieve a page of projects associated with a specific Asana workspace. Use the returned pagination information to retrieve additional pages.
>
> #### Input Parameters
>
> **limit** `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.
>
> **offset** `string`
>
> Offset token for pagination.
>
> **opt\_expand** `array`
>
> Fields to expand in the response.
>
> **opt\_fields** `array`
>
> Fields to include in the response.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reorder Enum Option for Custom Field
>
> **Slug:** `ASANA_INSERT_ENUM_OPTION_FOR_CUSTOM_FIELD`
>
> Tool to reorder an existing enum option within a custom field by moving it before or after another specified enum option. 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
>
> **data** `object` *required*
>
> The data for the enum option to be inserted or reordered.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **custom\_field\_gid** `string` *required*
>
> Globally unique identifier for the custom field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Move or Insert Section in Project
>
> **Slug:** `ASANA_INSERT_SECTION_FOR_PROJECT`
>
> Tool 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
>
> **data** `object` *required*
>
> The data specifying which section to move and where to position it.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Instantiate Project Template
>
> **Slug:** `ASANA_INSTANTIATE_PROJECT_TEMPLATE`
>
> Instantiate (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
>
> **name** `string` *required*
>
> The name for the new project that will be created from the template.
>
> **team** `string`
>
> Globally unique identifier for the team that the new project will belong to. Required if the template is a team template.
>
> **is\_strict** `boolean`
>
> If true, requires all date and role variables from the template to be provided. If false or omitted, missing variables will use defaults.
>
> **opt\_fields** `array`
>
> Optional fields to include in the response. Common values: gid, status, new\_project, new\_project\_template.
>
> **opt\_pretty** `boolean`
>
> If true, returns human-readable JSON response (for debugging only due to size/processing impact).
>
> **privacy\_setting** `string ("public_to_workspace" | "private_to_team" | "private")`
>
> Privacy setting for the new project. If not specified, inherits from template or team settings.
>
> **requested\_dates** `array`
>
> Array of date variable assignments. Required if the template includes date variables and is\_strict is true.
>
> **requested\_roles** `array`
>
> Array of role assignments mapping template roles to specific users.
>
> **project\_template\_gid** `string` *required*
>
> Globally unique identifier for the project template to instantiate.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Instantiate a task from a task template
>
> **Slug:** `ASANA_INSTANTIATE_TASK_TEMPLATE`
>
> Instantiate a task from a task template.
>
> #### Input Parameters
>
> **data** `object`
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **task\_template\_gid** `string` *required*
>
> Globally unique identifier for the task template.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get goal relationships
>
> **Slug:** `ASANA_LIST_GOAL_RELATIONSHIPS`
>
> Get goal relationships. Returns one page; pass next\_page.offset with the same filters to continue. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Results per page. The number of objects to return per page. The value must be between 1 and 100.
>
> **offset** `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.*
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **supported\_goal** `string` *required*
>
> Globally unique identifier for the supported goal in the goal relationship.
>
> **resource\_subtype** `string`
>
> If provided, filter to goal relationships with a given resource\_subtype.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Dependencies
>
> **Slug:** `ASANA_LIST_TASK_DEPENDENCIES`
>
> List the prerequisite tasks that must be completed before an Asana task.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of dependencies to return per page (1-100).
>
> **offset** `string`
>
> Opaque offset token returned by a previous page of results.
>
> **task\_gid** `string` *required*
>
> Globally unique identifier for the dependent task.
>
> **opt\_fields** `array`
>
> Fields to include in each dependency task representation.
>
> **opt\_pretty** `boolean`
>
> Whether to return human-readable JSON with indentation and line breaks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Task Dependents
>
> **Slug:** `ASANA_LIST_TASK_DEPENDENTS`
>
> List tasks that are blocked by a specified Asana task.
>
> #### Input Parameters
>
> **limit** `integer`
>
> The number of dependents to return per page, from 1 to 100.
>
> **offset** `string`
>
> The opaque offset token returned in next\_page.offset for the next page.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task whose dependents should be listed.
>
> **opt\_fields** `array`
>
> Fields to include for each dependent task. They are sent to Asana as a comma-separated list.
>
> **opt\_pretty** `boolean`
>
> Whether Asana should format the JSON response for human readability.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Reject access request
>
> **Slug:** `ASANA_REJECT_ACCESS_REQUEST`
>
> Tool to reject an access request. Use when you need to deny a user's request for access to a project or resource.
>
> #### Input Parameters
>
> **access\_request\_gid** `string` *required*
>
> Globally unique identifier for the access request to reject. Must be a numeric string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a custom field from a goal
>
> **Slug:** `ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_GOAL`
>
> Remove a custom field from a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a custom field from a portfolio
>
> **Slug:** `ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PORTFOLIO`
>
> Remove a custom field from a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a custom field from a project
>
> **Slug:** `ASANA_REMOVE_CUSTOM_FIELD_SETTING_FOR_PROJECT`
>
> Remove a custom field from a project.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Follower From Task
>
> **Slug:** `ASANA_REMOVE_FOLLOWER_FROM_TASK`
>
> Tool to remove one or more followers from a task. Use when you need to update the list of users following a specific task.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task.
>
> **followers** `array` *required*
>
> An array of user GIDs to remove as followers.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Followers For Project
>
> **Slug:** `ASANA_REMOVE_FOLLOWERS_FOR_PROJECT`
>
> Tool to remove followers from a project in Asana. Use when you need to remove one or more users as followers from a specific project.
>
> #### Input Parameters
>
> **followers** `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](mailto:user@example.com)".
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove a collaborator from a goal
>
> **Slug:** `ASANA_REMOVE_FOLLOWERS_FROM_GOAL`
>
> Remove a collaborator from a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Item from Portfolio
>
> **Slug:** `ASANA_REMOVE_ITEM_FROM_PORTFOLIO`
>
> Tool 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
>
> **item** `string` *required*
>
> The globally unique identifier (GID) of the item (project or portfolio) to remove from the portfolio.
>
> **opt\_fields** `string`
>
> Comma-separated list of fields to include in the response. Limited utility for this endpoint as it returns an empty data block.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> The globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove users from a portfolio
>
> **Slug:** `ASANA_REMOVE_MEMBERS_FOR_PORTFOLIO`
>
> Remove users from a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Members from Project
>
> **Slug:** `ASANA_REMOVE_MEMBERS_FOR_PROJECT`
>
> Tool to remove users from a project in Asana. Use this tool when you need to remove one or more users as members from a specific project.
>
> #### Input Parameters
>
> **members** `string` *required*
>
> A comma-separated string of user identifiers. These can be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Project from Task
>
> **Slug:** `ASANA_REMOVE_PROJECT_FROM_TASK`
>
> Tool to remove a project from a task in Asana. Use this when you need to disassociate a task from a specific project.
>
> #### Input Parameters
>
> **project** `string` *required*
>
> The project to remove the task from.
>
> **task\_gid** `string` *required*
>
> The task to operate on.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Removes a supporting goal relationship
>
> **Slug:** `ASANA_REMOVE_SUPPORTING_RELATIONSHIP`
>
> Removes a supporting goal relationship. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Tag from Task
>
> **Slug:** `ASANA_REMOVE_TAG_FROM_TASK`
>
> Tool to remove an existing tag from a task in Asana. Use this tool when you need to detach a tag from a specific task for cleanup or retagging automation.
>
> #### Input Parameters
>
> **tag** `string` *required*
>
> The globally unique identifier for the tag to remove from the task.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Task Dependencies
>
> **Slug:** `ASANA_REMOVE_TASK_DEPENDENCIES`
>
> Tool to unlink selected prerequisite relationships from an Asana task without deleting any task.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The globally unique identifier for the task whose dependency relationships will be removed.
>
> **opt\_pretty** `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.
>
> **dependencies** `array` *required*
>
> An array of task GIDs to unlink as prerequisites of the target task. The tasks themselves are not deleted.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove Task Dependents
>
> **Slug:** `ASANA_REMOVE_TASK_DEPENDENTS`
>
> Unlink selected dependent tasks from an Asana prerequisite task without deleting any task.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The GID of the prerequisite task whose dependent relationships will be removed.
>
> **dependents** `array` *required*
>
> Task GIDs to unlink as dependents of this task. The tasks themselves are not deleted.
>
> **opt\_pretty** `boolean`
>
> Pretty-print the JSON response. Adds time and response size; use only for debugging.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove User For Team
>
> **Slug:** `ASANA_REMOVE_USER_FOR_TEAM`
>
> Tool to remove a user from a team. Use when you need to revoke team membership for a specific user.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> A string identifying a user. This can either be the string 'me', an email, or the gid of a user.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Remove User from Workspace
>
> **Slug:** `ASANA_REMOVE_USER_FOR_WORKSPACE`
>
> Tool to remove a user from a workspace or organization. Use when you need to revoke a user's access to a specific workspace.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Roll up subtask dates for a project
>
> **Slug:** `ASANA_ROLLUP_PROJECT`
>
> Start a background job to reconcile subtask dates in a project. Poll Get Job with the returned job gid to check completion.
>
> #### Input Parameters
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Roll up subtask dates for a task
>
> **Slug:** `ASANA_ROLLUP_TASK`
>
> Start a background job to reconcile a task's subtask dates. Poll Get Job with the returned job gid to check completion.
>
> #### Input Parameters
>
> **task\_gid** `string` *required*
>
> The task to operate on.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create a project template from a project
>
> **Slug:** `ASANA_SAVE_PROJECT_AS_TEMPLATE`
>
> Create a project template from a project.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_gid** `string` *required*
>
> Globally unique identifier for the project.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search projects in a workspace
>
> **Slug:** `ASANA_SEARCH_PROJECTS_FOR_WORKSPACE`
>
> Search projects in a workspace.
>
> #### Input Parameters
>
> **text** `string`
>
> Performs full-text search on the project name.
>
> **limit** `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.
>
> **due\_on** `string`
>
> ISO 8601 date string or `null`.
>
> **sort\_by** `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`.
>
> **start\_on** `string`
>
> ISO 8601 date string or `null`.
>
> **completed** `boolean`
>
> Filter on project completion status.
>
> **owner.any** `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.
>
> **teams.any** `string`
>
> Comma-separated list of team IDs.
>
> **created\_on** `string`
>
> ISO 8601 date string or `null`.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **members.any** `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.
>
> **members.not** `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.
>
> **completed\_on** `string`
>
> ISO 8601 date string or `null`.
>
> **due\_at.after** `string`
>
> ISO 8601 datetime string.
>
> **due\_on.after** `string`
>
> ISO 8601 date string.
>
> **due\_at.before** `string`
>
> ISO 8601 datetime string.
>
> **due\_on.before** `string`
>
> ISO 8601 date string.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> **portfolios.any** `string`
>
> Comma-separated list of portfolio IDs to filter on.
>
> **sort\_ascending** `boolean`
>
> Default `false`.
>
> **start\_on.after** `string`
>
> ISO 8601 date string.
>
> **start\_on.before** `string`
>
> ISO 8601 date string.
>
> **created\_at.after** `string`
>
> ISO 8601 datetime string.
>
> **created\_on.after** `string`
>
> ISO 8601 date string.
>
> **created\_at.before** `string`
>
> ISO 8601 datetime string.
>
> **created\_on.before** `string`
>
> ISO 8601 date string.
>
> **completed\_at.after** `string`
>
> ISO 8601 datetime string.
>
> **completed\_on.after** `string`
>
> ISO 8601 date string.
>
> **completed\_at.before** `string`
>
> ISO 8601 datetime string.
>
> **completed\_on.before** `string`
>
> ISO 8601 date string.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Tasks in Workspace
>
> **Slug:** `ASANA_SEARCH_TASKS_IN_WORKSPACE`
>
> Search 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
>
> **text** `string`
>
> Search for tasks containing this text in name or notes. At least one search filter must be provided.
>
> **limit** `integer`
>
> Maximum number of results to return (1-100).
>
> **opt\_fields** `array`
>
> Additional fields to include in each task object; see Asana API docs for available fields.
>
> **opt\_pretty** `boolean`
>
> Pretty-print the JSON response with indentation (useful for debugging).
>
> **assignee\_any** `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.
>
> **projects\_any** `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.
>
> **workspace\_gid** `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.
>
> **resource\_subtype** `string`
>
> Filter by task subtype: 'default\_task' for regular tasks, 'milestone' for milestones. At least one search filter must be provided.
>
> **composio\_execution\_message** `string`
>
> Message explaining any automatic modifications made to the request.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Set parent for task
>
> **Slug:** `ASANA_SET_PARENT_FOR_TASK`
>
> Tool to set the parent of a task in Asana. Use when you need to make a task a subtask of another task or remove the parent relationship.
>
> #### Input Parameters
>
> **parent** `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.
>
> **task\_gid** `string` *required*
>
> The globally unique identifier (GID) of the task to set the parent for.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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.
>
> **insert\_after** `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.
>
> **insert\_before** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Submit Parallel Requests (Batch API)
>
> **Slug:** `ASANA_SUBMIT_PARALLEL_REQUESTS`
>
> Submit 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
>
> **data** `object` *required*
>
> Contains the list of actions to be performed in parallel.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Trigger a rule
>
> **Slug:** `ASANA_TRIGGER_RULE`
>
> Trigger a rule. Runs the configured rule and may trigger external side effects; use only a rule you intend to run.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **rule\_trigger\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Allocation
>
> **Slug:** `ASANA_UPDATE_ALLOCATION`
>
> Tool to update an existing allocation by its ID. Use this when you need to modify details like the start date, end date, effort, or assignee for an allocation.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The data to update the allocation with.
>
> **opt\_fields** `array`
>
> A comma-separated list of fields to include in the response.
>
> **opt\_pretty** `boolean`
>
> If true, the response will be in a human-readable format.
>
> **allocation\_gid** `string` *required*
>
> Globally unique identifier for the allocation to be updated.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a task
>
> **Slug:** `ASANA_UPDATE_A_TASK`
>
> Updates attributes of an existing Asana task identified by its task\_gid.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> An object containing the fields of the task to update.
>
> **task\_gid** `string` *required*
>
> The GID of the task to update.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a budget
>
> **Slug:** `ASANA_UPDATE_BUDGET`
>
> Update a budget.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *budget* object represents a budget for a given parent.
>
> **budget\_gid** `string` *required*
>
> Globally unique identifier for the budget.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Custom Field
>
> **Slug:** `ASANA_UPDATE_CUSTOM_FIELD`
>
> Update the name or description of a custom field by its globally unique identifier.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The data to update the custom field with.
>
> **opt\_fields** `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.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **custom\_field\_gid** `string` *required*
>
> Globally unique identifier for the custom field.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Enum Option
>
> **Slug:** `ASANA_UPDATE_ENUM_OPTION`
>
> Tool to update an enum option for a custom field. Use when you need to modify the name, color, or enabled status of an existing enum option.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> The data to update the enum option with.
>
> **opt\_fields** `array`
>
> Defines the fields to be returned in the response.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output. Formatting of the result will follow JSON pretty print conventions (line breaks and indentation).
>
> **enum\_option\_gid** `string` *required*
>
> Globally unique identifier for the enum option.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a goal
>
> **Slug:** `ASANA_UPDATE_GOAL`
>
> Update a goal. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a goal metric
>
> **Slug:** `ASANA_UPDATE_GOAL_METRIC`
>
> Update a goal metric. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **goal\_gid** `string` *required*
>
> Globally unique identifier for the goal.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a goal relationship
>
> **Slug:** `ASANA_UPDATE_GOAL_RELATIONSHIP`
>
> Update a goal relationship. Requires an Asana subscription with Goals access.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *goal relationship* is an object representing the relationship between a goal and another goal, a project, a task, or a portfolio.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **goal\_relationship\_gid** `string` *required*
>
> Globally unique identifier for the goal relationship.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a membership
>
> **Slug:** `ASANA_UPDATE_MEMBERSHIP`
>
> Update a membership.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_pretty** `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.
>
> **membership\_gid** `string` *required*
>
> Globally unique identifier for the membership.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update an OOO entry
>
> **Slug:** `ASANA_UPDATE_OOO_ENTRY`
>
> Update an OOO entry.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **ooo\_entry\_gid** `string` *required*
>
> Globally unique identifier for the OOO entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a portfolio
>
> **Slug:** `ASANA_UPDATE_PORTFOLIO`
>
> Update a portfolio. Requires an Asana plan with Portfolios access.
>
> #### Input Parameters
>
> **data** `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.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **portfolio\_gid** `string` *required*
>
> Globally unique identifier for the portfolio.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a project
>
> **Slug:** `ASANA_UPDATE_PROJECT`
>
> Update a project.
>
> #### Input Parameters
>
> **name** `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.
>
> **team** `string`
>
> The GID of the team that this project is shared with.
>
> **color** `string`
>
> Color of the project.
>
> **notes** `string`
>
> Free-form textual information associated with the project (its description).
>
> **owner** `string`
>
> The GID of the new owner of the project. May be null.
>
> **due\_on** `string`
>
> The day on which this project is due. This takes a date with format YYYY-MM-DD.
>
> **public** `boolean`
>
> True if the project is public to its team.
>
> **archived** `boolean`
>
> True if the project is archived, false if not.
>
> **due\_date** `string`
>
> The localized day on which this project is due. This takes a date with format YYYY-MM-DD.
>
> **start\_on** `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.
>
> **html\_notes** `string`
>
> Opt In. The notes of the project with formatting as HTML.
>
> **is\_template** `boolean`
>
> Opt In. True if the project is a template.
>
> **project\_gid** `string` *required*
>
> The GID of the project to update.
>
> **default\_view** `string`
>
> The default view (list, board, calendar, or timeline) of a project.
>
> **custom\_fields** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Project Brief
>
> **Slug:** `ASANA_UPDATE_PROJECT_BRIEF`
>
> Tool to update a project brief by its GID. Use when you need to modify the content/description of a project brief. 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
>
> **text** `string`
>
> The plain text content of the project brief. This field updates the main content/description of the project brief.
>
> **opt\_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. Available options: html\_text, permalink\_url, project, project.name, text, title
>
> **opt\_pretty** `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.
>
> **project\_brief\_gid** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a project portfolio setting
>
> **Slug:** `ASANA_UPDATE_PROJECT_PORTFOLIO_SETTING`
>
> Update a project portfolio setting.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **project\_portfolio\_setting\_gid** `string` *required*
>
> Globally unique identifier for the project portfolio setting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a rate
>
> **Slug:** `ASANA_UPDATE_RATE`
>
> Update a rate.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A generic Asana Resource, containing a globally unique identifier.
>
> **rate\_gid** `string` *required*
>
> Globally unique identifier for the rate.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a role
>
> **Slug:** `ASANA_UPDATE_ROLE`
>
> Update a role.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *role* represents a group of permissions that can be assigned to a user or team.
>
> **role\_gid** `string` *required*
>
> Globally unique identifier for the role.
>
> **opt\_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.
>
> **opt\_pretty** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Section
>
> **Slug:** `ASANA_UPDATE_SECTION`
>
> Update a section's name or position within a project. Use when you need to rename a section or reorder sections by specifying insert\_before or insert\_after.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name for the section. This is the text displayed as the section header. Cannot be an empty string.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides 'pretty' output with proper line breaking and indentation. Advisable only during debugging as it increases response time and size.
>
> **section\_gid** `string` *required*
>
> The globally unique identifier for the section to update.
>
> **insert\_after** `string`
>
> An existing section within this project after which the section should be inserted. Cannot be provided together with insert\_before.
>
> **insert\_before** `string`
>
> An existing section within this project before which the section should be inserted. Cannot be provided together with insert\_after.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Story
>
> **Slug:** `ASANA_UPDATE_STORY`
>
> Tool to update a story on a task. Use when you need to modify the text, html\_text, or pin status of an existing story. Only comment stories can have text/html\_text updated, and only comment and attachment stories can be pinned.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> An object containing the fields of the story to update.
>
> **story\_gid** `string` *required*
>
> Globally unique identifier for the story.
>
> **opt\_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.
>
> **opt\_pretty** `boolean`
>
> Provides "pretty" output. In the case of JSON this means doing proper line breaking and indentation to make it readable.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Tag
>
> **Slug:** `ASANA_UPDATE_TAG`
>
> Tool 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
>
> **data** `object` *required*
>
> An object containing the fields to update.
>
> **tag\_gid** `string` *required*
>
> The globally unique identifier for the tag.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a team
>
> **Slug:** `ASANA_UPDATE_TEAM`
>
> Tool to update details of an existing team. Use when you need to change a team's name, description, or organization.
>
> #### Input Parameters
>
> **name** `string`
>
> The new name of the team.
>
> **team\_gid** `string` *required*
>
> Globally unique identifier for the team.
>
> **opt\_fields** `array`
>
> Defines fields to return.
>
> **opt\_pretty** `boolean`
>
> Provides “pretty” output.
>
> **description** `string`
>
> The new description of the team.
>
> **organization** `string`
>
> GID of the organization to which the team belongs. This is the GID of an organization, not its name.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a timesheet approval status
>
> **Slug:** `ASANA_UPDATE_TIMESHEET_APPROVAL_STATUS`
>
> Update a timesheet approval status.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A request to update a timesheet approval status.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **timesheet\_approval\_status\_gid** `string` *required*
>
> Globally unique identifier for the timesheet approval status.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a time tracking category
>
> **Slug:** `ASANA_UPDATE_TIME_TRACKING_CATEGORY`
>
> Update a time tracking category.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **time\_tracking\_category\_gid** `string` *required*
>
> Globally unique identifier for the time tracking category.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a time tracking entry
>
> **Slug:** `ASANA_UPDATE_TIME_TRACKING_ENTRY`
>
> Update a time tracking entry.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> Data
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **time\_tracking\_entry\_gid** `string` *required*
>
> Globally unique identifier for the time tracking entry.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User
>
> **Slug:** `ASANA_UPDATE_USER`
>
> Update a user's custom fields. Note: Asana's API has very limited user update capabilities - most user properties are read-only and managed by users themselves.
>
> #### Input Parameters
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **workspace** `string`
>
> The workspace to filter results on.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **custom\_fields** `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
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update User for Workspace
>
> **Slug:** `ASANA_UPDATE_USER_FOR_WORKSPACE`
>
> Tool to update a user in a workspace or organization. Use when you need to modify user-specific custom field values for a workspace.
>
> #### Input Parameters
>
> **user\_gid** `string` *required*
>
> A string identifying a user. This can either be the string "me", an email, or the gid of a user.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **custom\_fields** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a webhook
>
> **Slug:** `ASANA_UPDATE_WEBHOOK`
>
> Update an existing Asana webhook's event filter configuration. At least one non-empty filter is required.
>
> #### Input Parameters
>
> **filters** `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.
>
> **opt\_fields** `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'.
>
> **opt\_pretty** `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.
>
> **webhook\_gid** `string` *required*
>
> Globally unique identifier for the webhook to update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update a workspace
>
> **Slug:** `ASANA_UPDATE_WORKSPACE`
>
> Update a workspace.
>
> #### Input Parameters
>
> **data** `object` *required*
>
> A *workspace* is the highest-level organizational unit in Asana. All projects and tasks have an associated workspace.
>
> **opt\_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.
>
> **opt\_pretty** `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.
>
> **workspace\_gid** `string` *required*
>
> Globally unique identifier for the workspace or organization.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

## Triggers

> [accordion] Attachment Added to Task
>
> **Slug:** `ASANA_TASK_ATTACHMENT_ADDED`
>
> **Type:** webhook
>
> Triggers when an attachment is added to a task.
>
> #### Configuration
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> #### Payload
>
> **attachment\_gid** `string` *required*
>
> GID of the attachment
>
> **attachment\_subtype** `string`
>
> Subtype of the attachment (e.g. 'external')
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **task\_gid** `string` *required*
>
> GID of the task the attachment was added to
>
> **user\_gid** `string`
>
> GID of the user who added the attachment

> [accordion] New Comment on Task
>
> **Slug:** `ASANA_TASK_COMMENT_ADDED`
>
> **Type:** webhook
>
> Triggers when a comment is added to a task in a project.
>
> #### Configuration
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> #### Payload
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **story\_gid** `string` *required*
>
> GID of the comment story
>
> **task\_gid** `string` *required*
>
> GID of the task the comment was added to
>
> **user\_gid** `string`
>
> GID of the user who posted the comment

> [accordion] New Task Created
>
> **Slug:** `ASANA_TASK_CREATED`
>
> **Type:** webhook
>
> Triggers when a new task is created in a project.
>
> #### Configuration
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> #### Payload
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **project\_gid** `string` *required*
>
> GID of the project the task was added to
>
> **task\_gid** `string` *required*
>
> GID of the created task
>
> **user\_gid** `string`
>
> GID of the user who created the task

> [accordion] Task Moved to Section
>
> **Slug:** `ASANA_TASK_MOVED_TO_SECTION`
>
> **Type:** webhook
>
> Triggers when a task is moved to a section in a project.
>
> #### Configuration
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> **section\_gid** `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
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **section\_gid** `string` *required*
>
> GID of the destination section
>
> **task\_gid** `string` *required*
>
> GID of the task that was moved
>
> **user\_gid** `string`
>
> GID of the user who moved the task

> [accordion] Tag Added to Task
>
> **Slug:** `ASANA_TASK_TAG_ADDED`
>
> **Type:** webhook
>
> Triggers 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
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> **tag\_gid** `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
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **tag\_gid** `string` *required*
>
> GID of the tag that was added
>
> **task\_gid** `string` *required*
>
> GID of the task the tag was added to
>
> **user\_gid** `string`
>
> GID of the user who added the tag

> [accordion] Task Updated
>
> **Slug:** `ASANA_TASK_UPDATED`
>
> **Type:** webhook
>
> Triggers when a task is updated in a project.
>
> #### Configuration
>
> **fields** `array`
>
> Only trigger when one of these fields changes (e.g. \['assignee', 'due\_on', 'name']). If not set, triggers on any field change.
>
> **project\_gid** `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;/](https://app.asana.com/0/\&#123;project_gid\&#125;/)...). Must be a GID — project names are not accepted.
>
> #### Payload
>
> **change\_action** `string` *required*
>
> The change action (e.g. 'changed')
>
> **change\_field** `string` *required*
>
> Name of the field that changed
>
> **created\_at** `string` *required*
>
> Timestamp of the event
>
> **new\_value** `object`
>
> New value of the field, if available
>
> **task\_gid** `string` *required*
>
> GID of the updated task
>
> **user\_gid** `string`
>
> GID of the user who made the change
