---
schema_version: "1"
id: d5977c0b2c8622ad8a529e5290973ff4b89e51f638267db037f823cc125cde35
title: Asana Connector Module Connector Reference
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/asana-connector/latest/asana-connector-reference.md
canonical_url: https://docs.mulesoft.com/asana-connector/latest/asana-connector-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 33b66ff968d3900b7536a0abfd60b8ff3ed25c9ef9aadf68f30f5b374ebb60d4
description: MuleSoft Documentation Site
release: "1.0"
latest: true
---
---
product: Asana Connector
version: 1.0
is-latest-version: true
---

# Asana Connector Module Connector Reference

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

Anypoint Connector for Asana (Asana Connector) synchronizes data and automates business processes
between Asana and third-party applications, either on-premises or in the cloud.

## Configurations

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Name</p></td><td><p>String</p></td><td><p>The name for this configuration. Connectors reference the configuration with this name.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Connection</p></td><td><div><div><ul><li><p><a href="#Config_Oauth2">Oauth2 Connection Provider</a></p></li><li><p><a href="#Config_Unsecured">Unsecured Connection Provider</a></p></li></ul></div></div></td><td><p>The connection types to provide to this configuration.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td><p>1</p></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td><p>MINUTES</p></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td><p>AUTO</p></td><td></td></tr><tr><td><p>Name</p></td><td><div><div><p>String</p></div></div></td><td><p>The identifier of this element used to reference it in other components</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Expiration Policy</p></td><td><div><div><p><a href="#ExpirationPolicy">Expiration Policy</a></p></div></div></td><td><p>Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.</p></td><td></td><td></td></tr></tbody></table>

## Connection Types

### Oauth2 Connection Provider

Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more
information, refer to
[Configuring OAuth 2.0 for Connectors](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2),
[Configuring OAuth 2.0 for Connectors on CloudHub](https://docs.mulesoft.com/connectors/introduction/intro-config-oauth2-cloudhub),
or [OAuth Support in the SDK](https://docs.mulesoft.com/mule-sdk/latest/oauth).

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Default Headers</p></td><td><div><div><p>Array of <a href="#DefaultHeader">Default Header</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Query Parameters</p></td><td><div><div><p>Array of <a href="#DefaultQueryParam">Default Query Param</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for establishing connections to the remote service</p></td><td><p>30</p></td><td></td></tr><tr><td><p>Connection Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Connection Timeout</p></td><td><p>SECONDS</p></td><td></td></tr><tr><td><p>Use Persistent Connections</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>If false, each connection will be closed after the first request is completed.</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Max Connections</p></td><td><div><div><p>Number</p></div></div></td><td><p>The maximum number of outbound connections to keep open at the same time</p></td><td><p>-1</p></td><td></td></tr><tr><td><p>Connection Idle Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>A timeout for how long a connection can remain idle before it is closed</p></td><td><p>30</p></td><td></td></tr><tr><td><p>Connection Idle Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the connection Idle Timeout</p></td><td><p>SECONDS</p></td><td></td></tr><tr><td><p>Proxy Config</p></td><td><div><div><p><a href="#Proxy">Proxy</a></p></div></div></td><td><p>Reusable configuration element for outbound connections through a proxy</p></td><td></td><td></td></tr><tr><td><p>Stream Response</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Whether or not received responses should be streamed</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Response Buffer Size</p></td><td><div><div><p>Number</p></div></div></td><td><p>The space in bytes for the buffer where the HTTP response will be stored.</p></td><td><p>-1</p></td><td></td></tr><tr><td><p>Base Uri</p></td><td><div><div><p>String</p></div></div></td><td><p>Parameter base URI, each instance/tenant gets its own</p></td><td></td><td></td></tr><tr><td><p>Protocol</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>HTTP</p></li><li><p>HTTPS</p></li></ul></div></div></td><td><p>Protocol to use for communication. Valid values are HTTP and HTTPS</p></td><td><p>HTTP</p></td><td></td></tr><tr><td><p>TLS Configuration</p></td><td><div><div><p><a href="#Tls">Tls</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr><tr><td><p>Consumer Key</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth consumerKey as registered with the service provider</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Consumer Secret</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth consumerSecret as registered with the service provider</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Authorization Url</p></td><td><div><div><p>String</p></div></div></td><td><p>The service provider’s authorization endpoint. URL</p></td><td><p><code>https://app.asana.com/-/oauth_authorize</code></p></td><td></td></tr><tr><td><p>Access Token Url</p></td><td><div><div><p>String</p></div></div></td><td><p>The service provider’s accessToken endpoint. URL</p></td><td><p><code>https://app.asana.com/-/oauth_token</code></p></td><td></td></tr><tr><td><p>Scopes</p></td><td><div><div><p>String</p></div></div></td><td><p>The OAuth scopes to be requested during the dance. If not provided, it defaults to those in the annotation</p></td><td><p>default openid email profile</p></td><td></td></tr><tr><td><p>Resource Owner Id</p></td><td><div><div><p>String</p></div></div></td><td><p>The resourceOwnerId which each component should use if it doesn’t reference otherwise.</p></td><td></td><td></td></tr><tr><td><p>Before</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a flow to execute right before starting the OAuth dance</p></td><td></td><td></td></tr><tr><td><p>After</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a flow to execute right after an accessToken has been received</p></td><td></td><td></td></tr><tr><td><p>Listener Config</p></td><td><div><div><p>String</p></div></div></td><td><p>A reference to a &lt;http:listener-config /&gt; to use to create the listener that will catch the access token callback endpoint..</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Callback Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path of the access token callback endpoint.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Authorize Path</p></td><td><div><div><p>String</p></div></div></td><td><p>The path of the local http endpoint. which triggers the OAuth dance</p></td><td></td><td><p>x</p></td></tr><tr><td><p>External Callback Url</p></td><td><div><div><p>String</p></div></div></td><td><p>If the callback endpoint. is behind a proxy or should be accessed through a non direct URL, use this parameter to tell the OAuth provider the URL it should use to access the callback</p></td><td></td><td></td></tr><tr><td><p>Object Store</p></td><td><div><div><p>String</p></div></div></td><td><p>A reference to the object store that should be used to store each resource owner id’s data. If not specified, runtime will automatically provision the default one.</p></td><td></td><td></td></tr></tbody></table>

### Unsecured Connection Provider

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Default Headers</p></td><td><div><div><p>Array of <a href="#DefaultHeader">Default Header</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Query Parameters</p></td><td><div><div><p>Array of <a href="#DefaultQueryParam">Default Query Param</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Connection Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for establishing connections to the remote service</p></td><td><p>30</p></td><td></td></tr><tr><td><p>Connection Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Connection Timeout</p></td><td><p>SECONDS</p></td><td></td></tr><tr><td><p>Use Persistent Connections</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>If false, each connection will be closed after the first request is completed.</p></td><td><p>true</p></td><td></td></tr><tr><td><p>Max Connections</p></td><td><div><div><p>Number</p></div></div></td><td><p>The maximum number of outbound connections to keep open at the same time</p></td><td><p>-1</p></td><td></td></tr><tr><td><p>Connection Idle Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>A timeout for how long a connection can remain idle before it is closed</p></td><td><p>30</p></td><td></td></tr><tr><td><p>Connection Idle Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the connection Idle Timeout</p></td><td><p>SECONDS</p></td><td></td></tr><tr><td><p>Proxy Config</p></td><td><div><div><p><a href="#Proxy">Proxy</a></p></div></div></td><td><p>Reusable configuration element for outbound connections through a proxy</p></td><td></td><td></td></tr><tr><td><p>Stream Response</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Whether or not received responses should be streamed</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Response Buffer Size</p></td><td><div><div><p>Number</p></div></div></td><td><p>The space in bytes for the buffer where the HTTP response will be stored.</p></td><td><p>-1</p></td><td></td></tr><tr><td><p>Base Uri</p></td><td><div><div><p>String</p></div></div></td><td><p>Parameter base URI, each instance/tenant gets its own</p></td><td></td><td></td></tr><tr><td><p>Protocol</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>HTTP</p></li><li><p>HTTPS</p></li></ul></div></div></td><td><p>Protocol to use for communication. Valid values are HTTP and HTTPS</p></td><td><p>HTTP</p></td><td></td></tr><tr><td><p>TLS Configuration</p></td><td><div><div><p><a href="#Tls">Tls</a></p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Reconnection</p></td><td><div><div><p><a href="#Reconnection">Reconnection</a></p></div></div></td><td><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></td><td></td><td></td></tr></tbody></table>

## Supported Operations

- [Create Batch Request](#CreateBatch)

- [Create Custom Field](#CreateCustomFields)

- [Create Enum Option For Custom Field](#CreateCustomFieldsEnumOptionsByCustomFieldGid)

- [Insert Enum Option For Custom Field](#CreateCustomFieldsEnumOptionsInsertByCustomFieldGid)

- [Create Organization Export](#CreateOrganizationExports)

- [Create Portfolio](#CreatePortfolios)

- [Add Custom Field Setting For Portfolio](#CreatePortfoliosAddCustomFieldSettingByPortfolioGid)

- [Add Item For Portfolio](#CreatePortfoliosAddItemByPortfolioGid)

- [Add Members For Portfolio](#CreatePortfoliosAddMembersByPortfolioGid)

- [Remove Custom Field Setting For Portfolio](#CreatePortfoliosRemoveCustomFieldSettingByPortfolioGid)

- [Remove Item For Portfolio](#CreatePortfoliosRemoveItemByPortfolioGid)

- [Remove Members For Portfolio](#CreatePortfoliosRemoveMembersByPortfolioGid)

- [Create Project](#CreateProjects)

- [Add Custom Field Setting For Project](#CreateProjectsAddCustomFieldSettingByProjectGid)

- [Add Followers For Project](#CreateProjectsAddFollowersByProjectGid)

- [Add Members For Project](#CreateProjectsAddMembersByProjectGid)

- [Duplicate Project](#CreateProjectsDuplicateByProjectGid)

- [Create Project Status For Project](#CreateProjectsProjectStatusesByProjectGid)

- [Remove Custom Field Setting For Project](#CreateProjectsRemoveCustomFieldSettingByProjectGid)

- [Remove Followers For Project](#CreateProjectsRemoveFollowersByProjectGid)

- [Remove Members For Project](#CreateProjectsRemoveMembersByProjectGid)

- [Create Section For Project](#CreateProjectsSectionsByProjectGid)

- [Insert Section For Project](#CreateProjectsSectionsInsertByProjectGid)

- [Add Task For Section](#CreateSectionsAddTaskBySectionGid)

- [Create Tag](#CreateTags)

- [Create Task](#CreateTasks)

- [Add Dependencies For Task](#CreateTasksAddDependenciesByTaskGid)

- [Add Dependents For Task](#CreateTasksAddDependentsByTaskGid)

- [Add Followers For Task](#CreateTasksAddFollowersByTaskGid)

- [Add Project For Task](#CreateTasksAddProjectByTaskGid)

- [Add Tag For Task](#CreateTasksAddTagByTaskGid)

- [Create Attachment For Task](#CreateTasksAttachmentsByTaskGid)

- [Duplicate Task](#CreateTasksDuplicateByTaskGid)

- [Remove Dependencies For Task](#CreateTasksRemoveDependenciesByTaskGid)

- [Remove Dependents For Task](#CreateTasksRemoveDependentsByTaskGid)

- [Remove Follower For Task](#CreateTasksRemoveFollowersByTaskGid)

- [Remove Project For Task](#CreateTasksRemoveProjectByTaskGid)

- [Remove Tag For Task](#CreateTasksRemoveTagByTaskGid)

- [Set Parent For Task](#CreateTasksSetParentByTaskGid)

- [Create Story For Task](#CreateTasksStoriesByTaskGid)

- [Create Subtask For Task](#CreateTasksSubtasksByTaskGid)

- [Create Team](#CreateTeams)

- [Add User For Team](#CreateTeamsAddUserByTeamGid)

- [Create Project For Team](#CreateTeamsProjectsByTeamGid)

- [Remove User For Team](#CreateTeamsRemoveUserByTeamGid)

- [Create Webhook](#CreateWebhooks)

- [Add User For Workspace](#CreateWorkspacesAddUserByWorkspaceGid)

- [Create Project For Workspace](#CreateWorkspacesProjectsByWorkspaceGid)

- [Remove User For Workspace](#CreateWorkspacesRemoveUserByWorkspaceGid)

- [Create Tag For Workspace](#CreateWorkspacesTagsByWorkspaceGid)

- [Delete Attachment](#DeleteAttachmentsByAttachmentGid)

- [Delete Custom Field](#DeleteCustomFieldsByCustomFieldGid)

- [Delete Portfolio](#DeletePortfoliosByPortfolioGid)

- [Delete Project Status](#DeleteProjectStatusesByProjectStatusGid)

- [Delete Project](#DeleteProjectsByProjectGid)

- [Delete Section](#DeleteSectionsBySectionGid)

- [Delete Story](#DeleteStoriesByStoryGid)

- [Delete Tag](#DeleteTagsByTagGid)

- [Delete Task](#DeleteTasksByTaskGid)

- [Delete Webhook](#DeleteWebhooksByWebhookGid)

- [Get Attachment](#GetAttachmentsByAttachmentGid)

- [Get Custom Field](#GetCustomFieldsByCustomFieldGid)

- [Get Events](#GetEvents)

- [Get Job](#GetJobsByJobGid)

- [Get Organization Export](#GetOrganizationExportsByOrganizationExportGid)

- [Get Teams For Organization](#GetOrganizationsTeamsByWorkspaceGid)

- [Get Portfolio Memberships](#GetPortfolioMemberships)

- [Get Portfolio Membership](#GetPortfolioMembershipsByPortfolioMembershipGid)

- [Get Portfolios](#GetPortfolios)

- [Get Portfolio](#GetPortfoliosByPortfolioGid)

- [Get Custom Field Settings For Portfolio](#GetPortfoliosCustomFieldSettingsByPortfolioGid)

- [Get Items For Portfolio](#GetPortfoliosItemsByPortfolioGid)

- [Get Portfolio Memberships For Portfolio](#GetPortfoliosPortfolioMembershipsByPortfolioGid)

- [Get Project Membership](#GetProjectMembershipsByProjectMembershipGid)

- [Get Project Status](#GetProjectStatusesByProjectStatusGid)

- [Get Projects](#GetProjects)

- [Get Project](#GetProjectsByProjectGid)

- [Get Custom Field Settings For Project](#GetProjectsCustomFieldSettingsByProjectGid)

- [Get Project Memberships For Project](#GetProjectsProjectMembershipsByProjectGid)

- [Get Project Statuses For Project](#GetProjectsProjectStatusesByProjectGid)

- [Get Sections For Project](#GetProjectsSectionsByProjectGid)

- [Get Task Counts For Project](#GetProjectsTaskCountsByProjectGid)

- [Get Tasks For Project](#GetProjectsTasksByProjectGid)

- [Get Section](#GetSectionsBySectionGid)

- [Get Tasks For Section](#GetSectionsTasksBySectionGid)

- [Get Story](#GetStoriesByStoryGid)

- [Get Tags](#GetTags)

- [Get Tag](#GetTagsByTagGid)

- [Get Tasks For Tag](#GetTagsTasksByTagGid)

- [Get Tasks](#GetTasks)

- [Get Attachments For Task](#GetTasksAttachmentsByTaskGid)

- [Get Task](#GetTasksByTaskGid)

- [Get Dependencies For Task](#GetTasksDependenciesByTaskGid)

- [Get Dependents For Task](#GetTasksDependentsByTaskGid)

- [Get Projects For Task](#GetTasksProjectsByTaskGid)

- [Get Stories For Task](#GetTasksStoriesByTaskGid)

- [Get Subtasks For Task](#GetTasksSubtasksByTaskGid)

- [Get Tags For Task](#GetTasksTagsByTaskGid)

- [Get Team Memberships](#GetTeamMemberships)

- [Get Team Membership](#GetTeamMembershipsByTeamMembershipGid)

- [Get Team](#GetTeamsByTeamGid)

- [Get Projects For Team](#GetTeamsProjectsByTeamGid)

- [Get Team Memberships For Team](#GetTeamsTeamMembershipsByTeamGid)

- [Get Users For Team](#GetTeamsUsersByTeamGid)

- [Get User Task List](#GetUserTaskListsByUserTaskListGid)

- [Get Tasks For User Task List](#GetUserTaskListsTasksByUserTaskListGid)

- [Get Users](#GetUsers)

- [Get User](#GetUsersByUserGid)

- [Get Favorites For User](#GetUsersFavoritesByUserGid)

- [Get Team Memberships For User](#GetUsersTeamMembershipsByUserGid)

- [Get Teams For User](#GetUsersTeamsByUserGid)

- [Get User Task List For User](#GetUsersUserTaskListByUserGid)

- [Get Workspace Memberships For User](#GetUsersWorkspaceMembershipsByUserGid)

- [Get Webhooks](#GetWebhooks)

- [Get Webhook](#GetWebhooksByWebhookGid)

- [Get Workspace Membership](#GetWorkspaceMembershipsByWorkspaceMembershipGid)

- [Get Workspaces](#GetWorkspaces)

- [Get Workspace](#GetWorkspacesByWorkspaceGid)

- [Get Custom Fields For Workspace](#GetWorkspacesCustomFieldsByWorkspaceGid)

- [Get Projects For Workspace](#GetWorkspacesProjectsByWorkspaceGid)

- [Get Tags For Workspace](#GetWorkspacesTagsByWorkspaceGid)

- [Search Tasks For Workspace](#GetWorkspacesTasksSearchByWorkspaceGid)

- [Typeahead For Workspace](#GetWorkspacesTypeaheadByWorkspaceGid)

- [Get Users For Workspace](#GetWorkspacesUsersByWorkspaceGid)

- [Get Workspace Memberships For Workspace](#GetWorkspacesWorkspaceMembershipsByWorkspaceGid)

- [Unauthorize](#Unauthorize)

- [Update Custom Field](#UpdateCustomFieldsByCustomFieldGid)

- [Update Enum Option](#UpdateEnumOptionsByEnumOptionGid)

- [Update Portfolio](#UpdatePortfoliosByPortfolioGid)

- [Update Project](#UpdateProjectsByProjectGid)

- [Update Section](#UpdateSectionsBySectionGid)

- [Update Story](#UpdateStoriesByStoryGid)

- [Update Tag](#UpdateTagsByTagGid)

- [Update Task](#UpdateTasksByTaskGid)

- [Update Workspace](#UpdateWorkspacesByWorkspaceGid)

## Associated Sources

- [On Updated Task Trigger](#OnUpdatedTaskTrigger)

## Operations

## Create Batch Request

`<asana:create-batch>`

Make multiple requests in parallel to Asana’s API. This operation makes an HTTP POST request to the
/batch endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Batch Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Custom Field

`<asana:create-custom-fields>`

Creates a new custom field in a workspace. Every custom field is required to be created in a
specific workspace, and this workspace cannot be changed once set.

A custom field’s name must be unique within a workspace and not conflict with names of existing task
properties such as 'Due Date' or 'Assignee'.

A custom field’s type must be one of 'text', 'enum', or 'number'. Returns the full record of the
newly created custom field.

This operation makes an HTTP POST request to the /custom\_fields endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.</p></td><td></td><td></td></tr><tr><td><p>Custom Fields Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Enum Option For Custom Field

`<asana:create-custom-fields-enum-options-by-custom-field-gid>`

Creates an enum option and adds it to this custom field’s list of enum options. A custom field can
have at most 50 enum options (including disabled options). By default new enum options are inserted
at the end of a custom field’s list. Locked custom fields can only have enum options added by the
user who locked the field. Returns the full record of the newly created enum option. This operation
makes an HTTP POST request to the /custom\_fields/{custom\_field\_gid}/enum\_options endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Custom field gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the custom field.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Custom Fields Enum Options Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Insert Enum Option For Custom Field

`<asana:create-custom-fields-enum-options-insert-by-custom-field-gid>`

Moves a particular enum option to be either before or after another specified enum option in the
custom field. Locked custom fields can only be reordered by the user who locked the field.

This operation makes an HTTP POST request to the
/custom\_fields/{custom\_field\_gid}/enum\_options/insert endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Custom field gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the custom field.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Custom Fields Enum Options Insert Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Organization Export

`<asana:create-organization-exports>`

This method creates a request to export an Organization. Asana will complete the export at some
point after you create the request. This operation makes an HTTP POST request to the
/organization\_exports endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Organization Exports Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Portfolio

`<asana:create-portfolios>`

Creates a new portfolio in the given workspace with the supplied name. Note that portfolios created
in the Asana UI may have some state (like the 'Priority' custom field) which is automatically added
to the portfolio when it is created. Portfolios created via our API will **not** be created with the
same initial state to allow integrations to create their own starting state on a portfolio. This
operation makes an HTTP POST request to the /portfolios endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Custom Field Setting For Portfolio

`<asana:create-portfolios-add-custom-field-setting-by-portfolio-gid>`

Custom fields are associated with portfolios by way of custom field settings. This method creates a
setting for the portfolio. This operation makes an HTTP POST request to the
/portfolios/{portfolio\_gid}/addCustomFieldSetting endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Portfolios Add Custom Field Setting Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Item For Portfolio

`<asana:create-portfolios-add-item-by-portfolio-gid>`

Add an item to a portfolio. Returns an empty data block. This operation makes an HTTP POST request
to the /portfolios/{portfolio\_gid}/addItem endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Add Item Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Members For Portfolio

`<asana:create-portfolios-add-members-by-portfolio-gid>`

Adds the specified list of users as members of the portfolio. Returns the updated portfolio record.
This operation makes an HTTP POST request to the /portfolios/{portfolio\_gid}/addMembers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Add Members Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Custom Field Setting For Portfolio

`<asana:create-portfolios-remove-custom-field-setting-by-portfolio-gid>`

Removes a custom field setting from a portfolio. This operation makes an HTTP POST request to the
/portfolios/{portfolio\_gid}/removeCustomFieldSetting endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Portfolios Remove Custom Field Setting Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Item For Portfolio

`<asana:create-portfolios-remove-item-by-portfolio-gid>`

Remove an item from a portfolio. Returns an empty data block. This operation makes an HTTP POST
request to the /portfolios/{portfolio\_gid}/removeItem endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Remove Item Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Members For Portfolio

`<asana:create-portfolios-remove-members-by-portfolio-gid>`

Removes the specified list of users from members of the portfolio. Returns the updated portfolio
record. This operation makes an HTTP POST request to the /portfolios/{portfolio\_gid}/removeMembers
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Remove Members Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Project

`<asana:create-projects>`

Create a new project in a workspace or team. Every project is required to be created in a specific
workspace or organization, and this cannot be changed once set. Note that you can use the
`workspace` parameter regardless of whether or not it is an organization. If the workspace for your
project is an organization, you must also supply a `team` to share the project with. Returns the
full record of the newly created project. This operation makes an HTTP POST request to the /projects
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Custom Field Setting For Project

`<asana:create-projects-add-custom-field-setting-by-project-gid>`

Custom fields are associated with projects by way of custom field settings. This method creates a
setting for the project. This operation makes an HTTP POST request to the
/projects/{project\_gid}/addCustomFieldSetting endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Portfolios Add Custom Field Setting Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Followers For Project

`<asana:create-projects-add-followers-by-project-gid>`

Adds the specified list of users as followers to the project. Followers are a subset of members,
therefore if the users are not already members of the project they will also become members as a
result of this operation. Returns the updated project record. This operation makes an HTTP POST
request to the /projects/{project\_gid}/addFollowers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Add Followers Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Members For Project

`<asana:create-projects-add-members-by-project-gid>`

Adds the specified list of users as members of the project. Returns the updated project record. This
operation makes an HTTP POST request to the /projects/{project\_gid}/addMembers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Add Members Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Duplicate Project

`<asana:create-projects-duplicate-by-project-gid>`

Creates and returns a job that will asynchronously handle the duplication. This operation makes an
HTTP POST request to the /projects/{project\_gid}/duplicate endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Duplicate Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Project Status For Project

`<asana:create-projects-project-statuses-by-project-gid>`

Creates a new status update on the project. Returns the full record of the newly created project
status update. This operation makes an HTTP POST request to the
/projects/{project\_gid}/project\_statuses endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Project Statuses Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Custom Field Setting For Project

`<asana:create-projects-remove-custom-field-setting-by-project-gid>`

Removes a custom field setting from a project. This operation makes an HTTP POST request to the
/projects/{project\_gid}/removeCustomFieldSetting endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Portfolios Remove Custom Field Setting Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Followers For Project

`<asana:create-projects-remove-followers-by-project-gid>`

Removes the specified list of users from following the project, this will not affect project
membership status. Returns the updated project record. This operation makes an HTTP POST request to
the /projects/{project\_gid}/removeFollowers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Remove Followers Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Members For Project

`<asana:create-projects-remove-members-by-project-gid>`

Removes the specified list of users from members of the project. Returns the updated project record.
This operation makes an HTTP POST request to the /projects/{project\_gid}/removeMembers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Remove Members Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Section For Project

`<asana:create-projects-sections-by-project-gid>`

Creates a new section in a project. Returns the full record of the newly created section. This
operation makes an HTTP POST request to the /projects/{project\_gid}/sections endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Sections Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Insert Section For Project

`<asana:create-projects-sections-insert-by-project-gid>`

Move sections relative to each other. One of `before_section` or `after_section` is required.
Sections cannot be moved between projects. Returns an empty data block. This operation makes an HTTP
POST request to the /projects/{project\_gid}/sections/insert endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Sections Insert Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Task For Section

`<asana:create-sections-add-task-by-section-gid>`

Add a task to a specific, existing section. This will remove the task from other sections of the
project. The task is inserted at the top of a section unless an insert\_before or insert\_after
parameter is declared. This does not work for separators (tasks with the resource\_subtype of
section). This operation makes an HTTP POST request to the /sections/{section\_gid}/addTask
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Section gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The globally unique identifier for the section.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Sections Add Task Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Tag

`<asana:create-tags>`

Creates a new tag in a workspace or organization. Every tag is required to be created in a specific
workspace or organization, and this cannot be changed once set. Note that you can use the workspace
parameter regardless of whether or not it is an organization. Returns the full record of the newly
created tag. This operation makes an HTTP POST request to the /tags endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tags Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Task

`<asana:create-tasks>`

Creating a new task is as easy as POSTing to the `/tasks` endpoint. with a data block containing the
fields you’d like to set on the task. Any unspecified fields will take on default values. Every task
is required to be created in a specific workspace, and this workspace cannot be changed once set.
The workspace need not be set explicitly if you specify `projects` or a `parent` task instead. This
operation makes an HTTP POST request to the /tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Dependencies For Task

`<asana:create-tasks-add-dependencies-by-task-gid>`

Marks a set of tasks as dependencies of this task, if they are not already dependencies. **A task
can have at most 15 dependencies**. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/addDependencies endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Dependencies Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Dependents For Task

`<asana:create-tasks-add-dependents-by-task-gid>`

Marks a set of tasks as dependents of this task, if they are not already dependents. **A task can
have at most 30 dependents**. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/addDependents endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Dependents Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Followers For Task

`<asana:create-tasks-add-followers-by-task-gid>`

Adds followers to a task. Returns an empty data block. Each task can be associated with zero or more
followers in the system. Requests to add/remove followers, if successful, will return the complete
updated task record, described above. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/addFollowers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Followers Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Project For Task

`<asana:create-tasks-add-project-by-task-gid>`

Adds the task to the specified project, in the optional location specified. If no location arguments
are given, the task will be added to the end of the project. `addProject` can also be used to
reorder a task within a project or section that already contains it. At most one of `insert_before`,
`insert_after`, or `section` should be specified. Inserting into a section in an non-order-dependent
way can be done by specifying section, otherwise, to insert within a section in a particular place,
specify `insert_before` or `insert_after` and a task within the section to anchor the position of
this task. Returns an empty data block. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/addProject endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Project Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add Tag For Task

`<asana:create-tasks-add-tag-by-task-gid>`

Adds a tag to a task. Returns an empty data block. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/addTag endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Tag Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Attachment For Task

`<asana:create-tasks-attachments-by-task-gid>`

Upload an attachment. This method uploads an attachment to a task and returns the compact record for
the created attachment object. It is not possible to attach files from third party services such as
Dropbox, Box & Google Drive via the API.

You must download the file content first and then upload it as any other attachment.

The 100MB size limit on attachments in Asana is enforced on this endpoint. This endpoint expects a
multipart/form-data encoded request containing the full contents of the file to be uploaded.
Requests made should follow the HTTP/1.1 specification that line terminators are of the form `CRLF`
or `\r\n` outlined
\[here\](https://docs.mulesoft.com/asana-connector/latest/[https://www.w3.org/Protocols/HTTP/1.1/draft-ietf-http-v11-spec-01](https://www.w3.org/Protocols/HTTP/1.1/draft-ietf-http-v11-spec-01))
in order for the server to reliably and properly handle the request. This operation makes an HTTP
POST request to the /tasks/{task\_gid}/attachments endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Attachment Request Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Duplicate Task

`<asana:create-tasks-duplicate-by-task-gid>`

Creates and returns a job that will asynchronously handle the duplication. This operation makes an
HTTP POST request to the /tasks/{task\_gid}/duplicate endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Duplicate Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Dependencies For Task

`<asana:create-tasks-remove-dependencies-by-task-gid>`

Unlinks a set of dependencies from this task. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/removeDependencies endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Dependencies Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Dependents For Task

`<asana:create-tasks-remove-dependents-by-task-gid>`

Unlinks a set of dependents from this task. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/removeDependents endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Add Dependents Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Follower For Task

`<asana:create-tasks-remove-followers-by-task-gid>`

Removes each of the specified followers from the task if they are following. Returns the complete,
updated record for the affected task. This operation makes an HTTP POST request to the
/tasks/{task\_gid}/removeFollowers endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Remove Followers Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Project For Task

`<asana:create-tasks-remove-project-by-task-gid>`

Removes the task from the specified project. The task will still exist in the system, but it will
not be in the project anymore. Returns an empty data block. This operation makes an HTTP POST
request to the /tasks/{task\_gid}/removeProject endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Remove Project Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove Tag For Task

`<asana:create-tasks-remove-tag-by-task-gid>`

Removes a tag from a task. Returns an empty data block. This operation makes an HTTP POST request to
the /tasks/{task\_gid}/removeTag endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Remove Tag Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Set Parent For Task

`<asana:create-tasks-set-parent-by-task-gid>`

parent, or no parent task at all. Returns an empty data block. When using `insert_before` and
`insert_after`, at most one of those two options can be specified, and they must already be subtasks
of the parent. This operation makes an HTTP POST request to the /tasks/{task\_gid}/setParent
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Set Parent Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Story For Task

`<asana:create-tasks-stories-by-task-gid>`

Adds a story to a task. This endpoint. currently only allows for comment stories to be created. The
comment will be authored by the currently authenticated user, and timestamped when the server
receives the request. Returns the full record for the new story added to the task. This operation
makes an HTTP POST request to the /tasks/{task\_gid}/stories endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Stories Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Subtask For Task

`<asana:create-tasks-subtasks-by-task-gid>`

Creates a new subtask and adds it to the parent task. Returns the full record for the newly created
subtask. This operation makes an HTTP POST request to the /tasks/{task\_gid}/subtasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Team

`<asana:create-teams>`

Creates a team within the current workspace. This operation makes an HTTP POST request to the /teams
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Teams Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add User For Team

`<asana:create-teams-add-user-by-team-gid>`

The user making this call must be a member of the team to add others. The user being added must
exist in the same organization as the team. This operation makes an HTTP POST request to the
/teams/{team\_gid}/addUser endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Teams Add User Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Project For Team

`<asana:create-teams-projects-by-team-gid>`

Creates a project shared with the given team. Returns the full record of the newly created project.
This operation makes an HTTP POST request to the /teams/{team\_gid}/projects endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove User For Team

`<asana:create-teams-remove-user-by-team-gid>`

The user making this call must be a member of the team to remove themselves or others. This
operation makes an HTTP POST request to the /teams/{team\_gid}/removeUser endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Teams Remove User Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Webhook

`<asana:create-webhooks>`

Establishing a webhook is a two-part process. First, a simple HTTP POST request initiates the
creation similar to creating any other resource. Next, in the middle of this request comes the
confirmation handshake.

When a webhook is created, we will send a test POST to the target with an `X-Hook-Secret` header.
The target must respond with a `'200’OK` or `'204’No Content` and a matching `X-Hook-Secret` header
to confirm that this webhook subscription is indeed expected.

We strongly recommend storing this secret to use to verify future webhook event signatures. The POST
request to create the webhook will then return with the status of the request. If you do not
acknowledge the webhook’s confirmation handshake that it fails to setup, you will receive an error
in response to your attempt to create it.

This means you need to be able to receive and complete the webhook **while** the POST request is
in-flight (in other words, have a server that can handle requests asynchronously).

- Request

  `curl -H "Authorization: Bearer " \ -X POST https://app.asana.com/api/1.0/webhooks \ -d "resource=8675309" \ -d "target=https://example.com/receive-webhook/7654"`

- Handshake sent to: `https://example.com/ POST /receive-webhook/7654 X-Hook-Secret: <secret>`

- Handshake response sent by: example.com HTTP/1.1 '200’X-Hook-Secret: <secret>

- Response:

  HTTP/1.1 '201'{ "data": { "gid": "43214", "resource": { "gid": "8675309", "name": "Bugs" },
  "target": "https://example.com/receive-webhook/7654", "active": false, "last\_success\_at": null,
  "last\_failure\_at": null, "last\_failure\_content": null } }

This operation makes an HTTP POST request to the /webhooks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Webhooks Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Add User For Workspace

`<asana:create-workspaces-add-user-by-workspace-gid>`

Add a user to a workspace or organization. The user can be referenced by their globally unique user
ID or their email address. Returns the full user record for the invited user. This operation makes
an HTTP POST request to the /workspaces/{workspace\_gid}/addUser endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Workspaces Add User Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Project For Workspace

`<asana:create-workspaces-projects-by-workspace-gid>`

Returns the compact project records for all projects in the workspace. If the workspace for your
project is an organization, you must also supply a team to share the project with. Returns the full
record of the newly created project. This operation makes an HTTP POST request to the
/workspaces/{workspace\_gid}/projects endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Remove User For Workspace

`<asana:create-workspaces-remove-user-by-workspace-gid>`

Remove a user from a workspace or organization. The user making this call must be an admin in the
workspace. The user can be referenced by their globally unique user ID or their email address.
Returns an empty data record. This operation makes an HTTP POST request to the
/workspaces/{workspace\_gid}/removeUser endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Workspaces Remove User Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Create Tag For Workspace

`<asana:create-workspaces-tags-by-workspace-gid>`

Creates a new tag in a workspace or organization. Every tag is required to be created in a specific
workspace or organization, and this cannot be changed once set. Note that you can use the workspace
parameter regardless of whether or not it is an organization. Returns the full record of the newly
created tag. This operation makes an HTTP POST request to the /workspaces/{workspace\_gid}/tags
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Create Tags Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Attachment

`<asana:delete-attachments-by-attachment-gid>`

Deletes a specific, existing attachment. Returns an empty data record. This operation makes an HTTP
DELETE request to the /attachments/{attachment\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Attachment gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the attachment.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Custom Field

`<asana:delete-custom-fields-by-custom-field-gid>`

A specific, existing custom field can be deleted by making a DELETE request on the URL for that
custom field. Locked custom fields can only be deleted by the user who locked the field. Returns an
empty data record. This operation makes an HTTP DELETE request to the
/custom\_fields/{custom\_field\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Custom field gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the custom field.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Portfolio

`<asana:delete-portfolios-by-portfolio-gid>`

An existing portfolio can be deleted by making a DELETE request on the URL for that portfolio.
Returns an empty data record. This operation makes an HTTP DELETE request to the
/portfolios/{portfolio\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Project Status

`<asana:delete-project-statuses-by-project-status-gid>`

Deletes a specific, existing project status update. Returns an empty data record. This operation
makes an HTTP DELETE request to the /project\_statuses/{project\_status\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project status gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The project status update to get.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Project

`<asana:delete-projects-by-project-gid>`

A specific, existing project can be deleted by making a DELETE request on the URL for that project.
Returns an empty data record. This operation makes an HTTP DELETE request to the
/projects/{project\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Section

`<asana:delete-sections-by-section-gid>`

A specific, existing section can be deleted by making a DELETE request on the URL for that section.
Note that sections must be empty to be deleted. The last remaining section cannot be deleted.
Returns an empty data block. This operation makes an HTTP DELETE request to the
/sections/{section\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Section gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The globally unique identifier for the section.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Story

`<asana:delete-stories-by-story-gid>`

Deletes a story. A user can only delete stories they have created. Returns an empty data record.
This operation makes an HTTP DELETE request to the /stories/{story\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Story gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the story.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Tag

`<asana:delete-tags-by-tag-gid>`

A specific, existing tag can be deleted by making a DELETE request on the URL for that tag. Returns
an empty data record. This operation makes an HTTP DELETE request to the /tags/{tag\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Tag gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the tag.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Task

`<asana:delete-tasks-by-task-gid>`

A specific, existing task can be deleted by making a DELETE request on the URL for that task.
Deleted tasks go into the 'trash' of the user making the delete request. Tasks can be recovered from
the trash within a period of 30 days; afterward they are completely removed from the system. Returns
an empty data record. This operation makes an HTTP DELETE request to the /tasks/{task\_gid}
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Delete Webhook

`<asana:delete-webhooks-by-webhook-gid>`

This method **permanently** removes a webhook. Note that it may be possible to receive a request
that was already in flight after deleting the webhook, but no further requests will be issued. This
operation makes an HTTP DELETE request to the /webhooks/{webhook\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Webhook gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the webhook.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Attachment

`<asana:get-attachments-by-attachment-gid>`

Get the full record for a single attachment. This operation makes an HTTP GET request to the
/attachments/{attachment\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Attachment gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the attachment.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Custom Field

`<asana:get-custom-fields-by-custom-field-gid>`

Get the complete definition of a custom field’s metadata. Since custom fields can be defined for one
of a number of types, and these types have different data and behaviors, there are fields that are
relevant to a particular type. For instance, as noted above, enum\_options is only relevant for the
enum type and defines the set of choices that the enum could represent. The examples below show some
of these type-specific custom field definitions. This operation makes an HTTP GET request to the
/custom\_fields/{custom\_field\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Custom field gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the custom field.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Events

`<asana:get-events>`

Returns the full record for all events that have occurred since the sync token was created. A GET
request to the endpoint. /\[path\_to\_resource\]/events can be made in lieu of including the
resource ID in the data for the request.

NOTE: The resource returned will be the resource that triggered the event. This may be different
from the one that the events were requested for. For example, a subscription to a project will
contain events for tasks contained within the project.\* This operation makes an HTTP GET request to
the /events endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>resource</p></td><td><div><div><p>String</p></div></div></td><td><p>A resource ID to subscribe to. The resource can be a task or project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>sync</p></td><td><div><div><p>String</p></div></div></td><td><p>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.</p><p>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 <code>412 Precondition Failed</code> error, and include a fresh sync token in the response.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Job

`<asana:get-jobs-by-job-gid>`

Returns the full record for a job. This operation makes an HTTP GET request to the /jobs/{job\_gid}
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Job gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the job.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Organization Export

`<asana:get-organization-exports-by-organization-export-gid>`

Returns details of a previously-requested Organization export. This operation makes an HTTP GET
request to the /organization\_exports/{organization\_export\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Organization export gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the organization export.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Teams For Organization

`<asana:get-organizations-teams-by-workspace-gid>`

Returns the compact records for all teams in the organization visible to the authorized user. This
operation makes an HTTP GET request to the /organizations/{workspace\_gid}/teams endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Portfolio Memberships

`<asana:get-portfolio-memberships>`

Returns a list of portfolio memberships in compact representation. You must specify `portfolio`,
`portfolio` and `user`, or `workspace` and `user`. This operation makes an HTTP GET request to the
/portfolio\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>portfolio</p></td><td><div><div><p>String</p></div></div></td><td><p>The portfolio to filter results on.</p></td><td></td><td></td></tr><tr><td><p>user</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace to filter results on.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Portfolio Membership

`<asana:get-portfolio-memberships-by-portfolio-membership-gid>`

Returns the complete portfolio record for a single portfolio membership. This operation makes an
HTTP GET request to the /portfolio\_memberships/{portfolio\_membership\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio membership gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Portfolio membership gid</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Portfolios

`<asana:get-portfolios>`

Returns a list of the portfolios in compact representation that are owned by the current API user.
This operation makes an HTTP GET request to the /portfolios endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace or organization to filter portfolios on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>owner</p></td><td><div><div><p>String</p></div></div></td><td><p>The user who owns the portfolio. Currently, API users can only get a list of portfolios that they themselves own.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Portfolio

`<asana:get-portfolios-by-portfolio-gid>`

Returns the complete portfolio record for a single portfolio. This operation makes an HTTP GET
request to the /portfolios/{portfolio\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Custom Field Settings For Portfolio

`<asana:get-portfolios-custom-field-settings-by-portfolio-gid>`

Returns a list of all of the custom fields settings on a portfolio, in compact form. This operation
makes an HTTP GET request to the /portfolios/{portfolio\_gid}/custom\_field\_settings endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Items For Portfolio

`<asana:get-portfolios-items-by-portfolio-gid>`

Get a list of the items in compact form in a portfolio. This operation makes an HTTP GET request to
the /portfolios/{portfolio\_gid}/items endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Portfolio Memberships For Portfolio

`<asana:get-portfolios-portfolio-memberships-by-portfolio-gid>`

Returns the compact portfolio membership records for the portfolio. This operation makes an HTTP GET
request to the /portfolios/{portfolio\_gid}/portfolio\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>user</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Project Membership

`<asana:get-project-memberships-by-project-membership-gid>`

Returns the complete project record for a single project membership. This operation makes an HTTP
GET request to the /project\_memberships/{project\_membership\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project membership gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Project membership gid</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Project Status

`<asana:get-project-statuses-by-project-status-gid>`

Returns the complete record for a single status update. This operation makes an HTTP GET request to
the /project\_statuses/{project\_status\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project status gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The project status update to get.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Projects

`<asana:get-projects>`

Returns the compact project records for some filtered set of projects. Use one or more of the
parameters provided to filter the projects returned. **Note: This endpoint. may timeout for large
domains. Try filtering by team!** This operation makes an HTTP GET request to the /projects
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace or organization to filter projects on.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>team</p></td><td><div><div><p>String</p></div></div></td><td><p>The team to filter projects on.</p></td><td></td><td></td></tr><tr><td><p>archived</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Only return projects whose <code>archived</code> field takes on the value of this parameter.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Project

`<asana:get-projects-by-project-gid>`

Returns the complete project record for a single project. This operation makes an HTTP GET request
to the /projects/{project\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Custom Field Settings For Project

`<asana:get-projects-custom-field-settings-by-project-gid>`

Returns a list of all of the custom fields settings on a project, in compact form. Note that, as in
all queries to collections which return compact representation, `opt_fields` can be used to include
more data than is returned in the compact representation. See the \[getting started guide on
input/output
options\]([https://developers.asana.com/docs/overview](https://developers.asana.com/docs/overview))
for more information. This operation makes an HTTP GET request to the
/projects/{project\_gid}/custom\_field\_settings endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Project Memberships For Project

`<asana:get-projects-project-memberships-by-project-gid>`

Returns the compact project membership records for the project. This operation makes an HTTP GET
request to the /projects/{project\_gid}/project\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>user</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Project Statuses For Project

`<asana:get-projects-project-statuses-by-project-gid>`

Returns the compact project status update records for all updates on the project. This operation
makes an HTTP GET request to the /projects/{project\_gid}/project\_statuses endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Sections For Project

`<asana:get-projects-sections-by-project-gid>`

Returns the compact records for all sections in the specified project. This operation makes an HTTP
GET request to the /projects/{project\_gid}/sections endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Task Counts For Project

`<asana:get-projects-task-counts-by-project-gid>`

Get an object that holds task count fields. All fields are excluded by default. You must \[opt
in\](/docs/input-output-options) using `opt_fields` to get any information from this endpoint. This
endpoint has an additional \[rate limit\](/docs/standard-rate-limits) and each field counts
especially high against our \[cost limits\](/docs/cost-limits). Milestones are just tasks, so they
are included in the `num_tasks`, `num_incomplete_tasks`, and `num_completed_tasks` counts. This
operation makes an HTTP GET request to the /projects/{project\_gid}/task\_counts endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tasks For Project

`<asana:get-projects-tasks-by-project-gid>`

Returns the compact task records for all tasks within the given project, ordered by their priority
within the project. Tasks can exist in more than one project at a time. This operation makes an HTTP
GET request to the /projects/{project\_gid}/tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Section

`<asana:get-sections-by-section-gid>`

Returns the complete record for a single section. This operation makes an HTTP GET request to the
/sections/{section\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Section gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The globally unique identifier for the section.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tasks For Section

`<asana:get-sections-tasks-by-section-gid>`

**Board view only**: Returns the compact section records for all tasks within the given section.
This operation makes an HTTP GET request to the /sections/{section\_gid}/tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Section gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The globally unique identifier for the section.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Story

`<asana:get-stories-by-story-gid>`

Returns the full record for a single story. This operation makes an HTTP GET request to the
/stories/{story\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Story gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the story.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tags

`<asana:get-tags>`

Returns the compact tag records for some filtered set of tags. Use one or more of the parameters
provided to filter the tags returned. This operation makes an HTTP GET request to the /tags
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace to filter tags on.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tag

`<asana:get-tags-by-tag-gid>`

Returns the complete tag record for a single tag. This operation makes an HTTP GET request to the
/tags/{tag\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Tag gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the tag.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tasks For Tag

`<asana:get-tags-tasks-by-tag-gid>`

Returns the compact task records for all tasks with the given tag. Tasks can have more than one tag
at a time. This operation makes an HTTP GET request to the /tags/{tag\_gid}/tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Tag gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the tag.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tasks

`<asana:get-tasks>`

Returns the compact task records for some filtered set of tasks. Use one or more of the parameters
provided to filter the tasks returned. You must specify a `project` or `tag` if you do not specify
`assignee` and `workspace`. For more complex task retrieval, use
\[workspaces/{workspace\_gid}/tasks/search\](/docs/search-tasks-in-a-workspace). This operation
makes an HTTP GET request to the /tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>assignee</p></td><td><div><div><p>String</p></div></div></td><td><p>The assignee to filter tasks on. NOTE: If you specify <code>assignee</code>, you must also specify the <code>workspace</code> to filter on.</p></td><td></td><td></td></tr><tr><td><p>project</p></td><td><div><div><p>String</p></div></div></td><td><p>The project to filter tasks on.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>section</p></td><td><div><div><p>String</p></div></div></td><td><p>The section to filter tasks on. NOTE: Currently, this is only supported in board views.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace to filter tasks on. NOTE: If you specify <code>workspace</code>, you must also specify the <code>assignee</code> to filter on.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Modified since</p></td><td><div><div><p>String</p></div></div></td><td><p>Only return tasks that have been modified since the given time. NOTE: A task is considered 'modified' if any of its properties change, or associations between it and other objects are modified (, for example a task being added to a project). A task is not considered modified just because another object it is associated with (, for example a subtask) is modified. Actions that count as modifying the task include assigning, renaming, completing, and adding stories.</p></td><td></td><td></td></tr><tr><td><p>Completed since</p></td><td><div><div><p>String</p></div></div></td><td><p>Only return tasks that are either incomplete or that have been completed since this time.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Attachments For Task

`<asana:get-tasks-attachments-by-task-gid>`

Returns the compact records for all attachments on the task. This operation makes an HTTP GET
request to the /tasks/{task\_gid}/attachments endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Task

`<asana:get-tasks-by-task-gid>`

Returns the complete task record for a single task. This operation makes an HTTP GET request to the
/tasks/{task\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Dependencies For Task

`<asana:get-tasks-dependencies-by-task-gid>`

Returns the compact representations of all of the dependencies of a task. This operation makes an
HTTP GET request to the /tasks/{task\_gid}/dependencies endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Dependents For Task

`<asana:get-tasks-dependents-by-task-gid>`

Returns the compact representations of all of the dependents of a task. This operation makes an HTTP
GET request to the /tasks/{task\_gid}/dependents endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Projects For Task

`<asana:get-tasks-projects-by-task-gid>`

Returns a compact representation of all of the projects the task is in. This operation makes an HTTP
GET request to the /tasks/{task\_gid}/projects endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Stories For Task

`<asana:get-tasks-stories-by-task-gid>`

Returns the compact records for all stories on the task. This operation makes an HTTP GET request to
the /tasks/{task\_gid}/stories endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Subtasks For Task

`<asana:get-tasks-subtasks-by-task-gid>`

Returns a compact representation of all of the subtasks of a task. This operation makes an HTTP GET
request to the /tasks/{task\_gid}/subtasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tags For Task

`<asana:get-tasks-tags-by-task-gid>`

Get a compact representation of all of the tags the task has. This operation makes an HTTP GET
request to the /tasks/{task\_gid}/tags endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Team Memberships

`<asana:get-team-memberships>`

Returns compact team membership records. This operation makes an HTTP GET request to the
/team\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace. This parameter must be used with the user parameter.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>team</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>user</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user. This parameter must be used with the workspace parameter.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Team Membership

`<asana:get-team-memberships-by-team-membership-gid>`

Returns the complete team membership record for a single team membership. This operation makes an
HTTP GET request to the /team\_memberships/{team\_membership\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team membership gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Team membership gid</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Team

`<asana:get-teams-by-team-gid>`

Returns the full record for a single team. This operation makes an HTTP GET request to the
/teams/{team\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Projects For Team

`<asana:get-teams-projects-by-team-gid>`

Returns the compact project records for all projects in the team. This operation makes an HTTP GET
request to the /teams/{team\_gid}/projects endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>archived</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Only return projects whose <code>archived</code> field takes on the value of this parameter.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Team Memberships For Team

`<asana:get-teams-team-memberships-by-team-gid>`

Returns the compact team memberships for the team. This operation makes an HTTP GET request to the
/teams/{team\_gid}/team\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Users For Team

`<asana:get-teams-users-by-team-gid>`

Returns the compact records for all users that are members of the team. This operation makes an HTTP
GET request to the /teams/{team\_gid}/users endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Team gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the team.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get User Task List

`<asana:get-user-task-lists-by-user-task-list-gid>`

Returns the full record for a user task list. This operation makes an HTTP GET request to the
/user\_task\_lists/{user\_task\_list\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User task list gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the user task list.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tasks For User Task List

`<asana:get-user-task-lists-tasks-by-user-task-list-gid>`

Returns the compact list of tasks in a user’s My Tasks list.

Access control is enforced for this endpoint, as with all Asana API endpoint. A user’s private tasks
are filtered out if the API-authenticated user does not have access to them. Both complete and
incomplete tasks are returned by default unless they are filtered out (for example, setting
`completed_since=now` returns only incomplete tasks, which is the default view for 'My Tasks' in
Asana.) This operation makes an HTTP GET request to the
/user\_task\_lists/{user\_task\_list\_gid}/tasks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User task list gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the user task list.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Completed since</p></td><td><div><div><p>String</p></div></div></td><td><p>Only return tasks that are either incomplete or that have been completed since this time. Accepts a date-time string or the keyword <strong>now</strong>.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Users

`<asana:get-users>`

Returns the user records for all users in all workspaces and organizations accessible to the
authenticated user. Accepts an optional workspace ID parameter. Results are sorted by user ID. This
operation makes an HTTP GET request to the /users endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace or organization ID to filter users on.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get User

`<asana:get-users-by-user-gid>`

Returns the full user record for the single user with the provided ID. Results are sorted by user
ID. This operation makes an HTTP GET request to the /users/{user\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Favorites For User

`<asana:get-users-favorites-by-user-gid>`

Returns all of a user’s favorites in the given workspace, of the given type. Results are given in
order (The same order as Asana’s sidebar). This operation makes an HTTP GET request to the
/users/{user\_gid}/favorites endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Resource type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>PORTFOLIO</p></li><li><p>PROJECT</p></li><li><p>TAG</p></li><li><p>TASK</p></li><li><p>USER</p></li></ul></div></div></td><td><p>The resource type of favorites to be returned.</p></td><td><p>PROJECT</p></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace in which to get favorites.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Team Memberships For User

`<asana:get-users-team-memberships-by-user-gid>`

Returns the compact team membership records for the user. This operation makes an HTTP GET request
to the /users/{user\_gid}/team\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Teams For User

`<asana:get-users-teams-by-user-gid>`

Returns the compact records for all teams to which the given user is assigned. This operation makes
an HTTP GET request to the /users/{user\_gid}/teams endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>organization</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace or organization to filter teams on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get User Task List For User

`<asana:get-users-user-task-list-by-user-gid>`

Returns the full record for a user''s task list. This operation makes an HTTP GET request to the
/users/{user\_gid}/user\_task\_list endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace in which to get the user task list.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Workspace Memberships For User

`<asana:get-users-workspace-memberships-by-user-gid>`

Returns the compact workspace membership records for the user. This operation makes an HTTP GET
request to the /users/{user\_gid}/workspace\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>User gid</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Webhooks

`<asana:get-webhooks>`

Get the compact representation of all webhooks your app has registered for the authenticated user in
the given workspace. This operation makes an HTTP GET request to the /webhooks endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace to query for webhooks in.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>resource</p></td><td><div><div><p>String</p></div></div></td><td><p>Only return webhooks for the given resource.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Webhook

`<asana:get-webhooks-by-webhook-gid>`

Returns the full record for the given webhook. This operation makes an HTTP GET request to the
/webhooks/{webhook\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Webhook gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the webhook.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Workspace Membership

`<asana:get-workspace-memberships-by-workspace-membership-gid>`

Returns the complete workspace record for a single workspace membership. This operation makes an
HTTP GET request to the /workspace\_memberships/{workspace\_membership\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace membership gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Workspace membership gid</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Workspaces

`<asana:get-workspaces>`

Returns the compact records for all workspaces visible to the authorized user. This operation makes
an HTTP GET request to the /workspaces endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Workspace

`<asana:get-workspaces-by-workspace-gid>`

Returns the full workspace record for a single workspace. This operation makes an HTTP GET request
to the /workspaces/{workspace\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Custom Fields For Workspace

`<asana:get-workspaces-custom-fields-by-workspace-gid>`

Returns a list of the compact representation of all of the custom fields in a workspace. This
operation makes an HTTP GET request to the /workspaces/{workspace\_gid}/custom\_fields endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Projects For Workspace

`<asana:get-workspaces-projects-by-workspace-gid>`

Returns the compact project records for all projects in the workspace.

**NOTE:** This endpoint might time out for large domains. It is better to use the
`/teams/{team_gid}/projects` endpoint.

This operation makes an HTTP GET request to the /workspaces/{workspace\_gid}/projects endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>archived</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Only return projects whose <code>archived</code> field takes on the value of this parameter.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Tags For Workspace

`<asana:get-workspaces-tags-by-workspace-gid>`

Returns the compact tag records for some filtered set of tags. Use one or more of the parameters
provided to filter the tags returned. This operation makes an HTTP GET request to the
/workspaces/{workspace\_gid}/tags endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Search Tasks For Workspace

`<asana:get-workspaces-tasks-search-by-workspace-gid>`

To mirror the functionality of the Asana web app’s advanced search feature, the Asana API has a task
search endpoint that allows you to build complex filters to find and retrieve the exact data you
need. Premium access such as the Asana web product’s advanced search feature is only available to
premium Asana users. A user is premium if any of the following is true:

- The workspace in which the search is being performed is a premium workspace

- The user is a member of a premium team inside the workspace, even if a user is only a member of a
  premium team inside a non-premium workspace, the search will allow them to find data anywhere in
  the workspace, not just inside the premium team.

Making a search request using credentials of a non-premium user will result in a
`402 Payment Required` error.

Pagination Search results are not stable; repeating the same query multiple times may return the
data in a different order, even if the data does not change. Because of this, the traditional
\[pagination\](https://docs.mulesoft.com/asana-connector/latest/[https://developers.asana.com/docs/overview](https://developers.asana.com/docs/overview))
available elsewhere in the Asana API is not available here.

However, you can paginate manually by sorting the search results by their creation time and then
modifying each subsequent query to exclude data you have already seen. Page sizes are limited to a
maximum of 100 items, and can be specified by the `limit` query parameter.

Eventual consistency Changes in Asana (regardless of whether they’re made though the web product or
the API) are forwarded to our search infrastructure to be indexed. This process can take between 10
and 60 seconds to complete under normal operation, and longer during some production incidents.

Making a change to a task that would alter its presence in a particular search query will not be
reflected immediately. This is also true of the advanced search feature in the web product.

Rate limits - You might receive a `429 Too Many Requests` response if you hit any of our \[rate
limits\]([https://developers.asana.com/docs/overview](https://developers.asana.com/docs/overview)).

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p><strong>x</strong></p></td></tr><tr><td><p>Created on before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Created by any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Due on after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Tags all</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of tag IDs</p></td><td></td><td></td></tr><tr><td><p>Liked by not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Modified on</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string or <code>null</code></p></td><td></td><td></td></tr><tr><td><p>Is blocked</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Filter to tasks with incomplete dependencies</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Liked by any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Modified on after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Is blocking</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Filter to incomplete tasks with dependents</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Start on</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string or <code>null</code></p></td><td></td><td></td></tr><tr><td><p>Teams any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of team IDs</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty' output. Provides the response in a 'pretty' format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Tags any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of tag IDs</p></td><td></td><td></td></tr><tr><td><p>Portfolios any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of portfolio IDs</p></td><td></td><td></td></tr><tr><td><p>Followers not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Due at after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Sort ascending</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Default <code>false</code></p></td><td><p>false</p></td><td></td></tr><tr><td><p>Projects not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of project IDs</p></td><td></td><td></td></tr><tr><td><p>Is subtask</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Filter to subtasks</p></td><td><p>false</p></td><td></td></tr><tr><td><p>text</p></td><td><div><div><p>String</p></div></div></td><td><p>Performs full-text search on both task name and description</p></td><td></td><td></td></tr><tr><td><p>Tags not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of tag IDs</p></td><td></td><td></td></tr><tr><td><p>Created at before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Start on after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Completed on</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string or <code>null</code></p></td><td></td><td></td></tr><tr><td><p>Created at after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Sections not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of section or column IDs</p></td><td></td><td></td></tr><tr><td><p>completed</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Filter to completed tasks</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Modified at after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Start on before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Followers any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Modified at before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Sort by</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>DUE_DATE</p></li><li><p>CREATED_AT</p></li><li><p>COMPLETED_AT</p></li><li><p>LIKES</p></li><li><p>MODIFIED_AT</p></li></ul></div></div></td><td><p>One of <code>due_date</code>, <code>created_at</code>, <code>completed_at</code>, <code>likes</code>, or <code>modified_at</code>, defaults to <code>modified_at</code></p></td><td><p>MODIFIED_AT</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> 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.</p></td><td></td><td></td></tr><tr><td><p>Assigned by any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Assigned by not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Sections any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of section or column IDs</p></td><td></td><td></td></tr><tr><td><p>Created on after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Due at before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Due on</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string or <code>null</code></p></td><td></td><td></td></tr><tr><td><p>Commented on by not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Created on</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string or <code>null</code></p></td><td></td><td></td></tr><tr><td><p>Completed at before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Assignee any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Modified on before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Assignee not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Projects all</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of project IDs</p></td><td></td><td></td></tr><tr><td><p>Completed on after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Projects any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of project IDs</p></td><td></td><td></td></tr><tr><td><p>Sections all</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of section or column IDs</p></td><td></td><td></td></tr><tr><td><p>Completed at after</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 datetime string</p></td><td></td><td></td></tr><tr><td><p>Has attachment</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Filter to tasks with attachments</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Completed on before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Created by not</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Commented on by any</p></td><td><div><div><p>String</p></div></div></td><td><p>Comma-separated list of user identifiers</p></td><td></td><td></td></tr><tr><td><p>Due on before</p></td><td><div><div><p>String</p></div></div></td><td><p>ISO 8601 date string</p></td><td></td><td></td></tr><tr><td><p>Resource subtype</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>DEFAULT_TASK</p></li><li><p>MILESTONE</p></li></ul></div></div></td><td><p>Filters results by the task’s resource_subtype</p></td><td><p>MILESTONE</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to be used to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>The name of a variable on which the operation’s output will be placed</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression that will be evaluated against the operation’s output and the outcome of that expression will be stored in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Typeahead For Workspace

`<asana:get-workspaces-typeahead-by-workspace-gid>`

Retrieves objects in the workspace based on an auto-completion or typeahead search algorithm. This
feature is meant to provide results quickly, so do not rely on this API to provide extremely
accurate search results. The result set is limited to a single page of results with a maximum size,
so you won’t be able to fetch large numbers of results.

he typeahead search API provides search for objects from a single workspace. This endpoint should be
used to query for objects when creating an auto-completion/typeahead search feature. This API is
meant to provide results quickly and should not be relied upon for accurate or exhaustive search
results. The results sets are limited in size and cannot be paginated. Queries return a compact
representation of each object which is typically the gid and name fields.

For a specific set of fields or all of the fields, use field selectors to manipulate what data is
included in a response. Resources with type `user` are returned in order of most contacted to least
contacted. This is determined by task assignments, adding the user to projects, and adding the user
as a follower to tasks, messages, and so forth.

Resources with type `project` are returned in order of recency. This is determined when the user
visits the project, is added to the project, and completes tasks in the project. Resources with type
`task` are returned with priority placed on tasks the user is following, but no guarantee on the
order of those tasks. Leaving the `query` string empty or omitted will give you results, by
following the resource ordering as noted previously.

This could be used to list users or projects that are relevant for the requesting user’s api token.
This operation makes an HTTP GET request to the /workspaces/{workspace\_gid}/typeahead endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>count</p></td><td><div><div><p>Number</p></div></div></td><td><p>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. If there are fewer results found than requested, all will be returned.</p></td><td></td><td></td></tr><tr><td><p>Resource type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>CUSTOM_FIELD</p></li><li><p>PORTFOLIO</p></li><li><p>PROJECT</p></li><li><p>TAG</p></li><li><p>TASK</p></li><li><p>USER</p></li></ul></div></div></td><td><p>The type of values the typeahead should return. You can choose from one of the following: <code>custom_field</code>, <code>project</code>, <code>portfolio</code>, <code>tag</code>, <code>task</code>, and <code>user</code>. Note that unlike in the names of endpoint.s, the types listed here are in singular form (, for example <code>task</code>). Using multiple types is not yet supported.</p></td><td><p>USER</p></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>query</p></td><td><div><div><p>String</p></div></div></td><td><p>The string to use to search for relevant objects. If an empty string is passed in, the API will currently return an empty result set.</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>CUSTOM_FIELD</p></li><li><p>PORTFOLIO</p></li><li><p>PROJECT</p></li><li><p>TAG</p></li><li><p>TASK</p></li><li><p>USER</p></li></ul></div></div></td><td><p><strong>Deprecated: new integrations should prefer the resource_type field.</strong></p></td><td><p>USER</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Users For Workspace

`<asana:get-workspaces-users-by-workspace-gid>`

Returns the user records for all users in the specified workspace or organization. Results are
sorted alphabetically by user names. This operation makes an HTTP GET request to the
/workspaces/{workspace\_gid}/users endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Get Workspace Memberships For Workspace

`<asana:get-workspaces-workspace-memberships-by-workspace-gid>`

Returns the compact workspace membership records for the workspace. This operation makes an HTTP GET
request to the /workspaces/{workspace\_gid}/workspace\_memberships endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>user</p></td><td><div><div><p>String</p></div></div></td><td><p>A string identifying a user. This can either be the string "me", an email, or the gid of a user.</p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Unauthorize

`<asana:unauthorize>`

Deletes all the access token information of a given resource owner ID so that it’s impossible to
execute any operation for that user without doing the authorization dance again

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Resource Owner Id</p></td><td><div><div><p>String</p></div></div></td><td><p>The ID of the resource owner which access should be invalidated</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

## Update Custom Field

`<asana:update-custom-fields-by-custom-field-gid>`

A specific, existing custom field can be updated by making a PUT request on the URL for that custom
field. Only the fields provided in the `data` block are updated; any unspecified fields remain
unchanged when using this method. It is best to specify only those fields you want to change, or you
may overwrite changes made by another user since you last retrieved the custom field.

A custom field’s `type` cannot be updated. An enum custom field’s `enum_options` cannot be updated
with this endpoint. Instead see 'Work With Enum Options' for information on how to update
`enum_options`.

Locked custom fields can only be updated by the user who locked the field. Returns the complete
updated custom field record. This operation makes an HTTP PUT request to the
/custom\_fields/{custom\_field\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Custom field gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the custom field.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Custom Fields Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Enum Option

`<asana:update-enum-options-by-enum-option-gid>`

Updates an existing enum option. Enum custom fields require at least one enabled enum option. Locked
custom fields can only be updated by the user who locked the field. Returns the full record of the
updated enum option. This operation makes an HTTP PUT request to the
/enum\_options/{enum\_option\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Enum option gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the enum option.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Custom Fields Enum Options Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Portfolio

`<asana:update-portfolios-by-portfolio-gid>`

An existing portfolio can be updated by making a PUT request on the URL for that portfolio. Only the
fields provided in the `data` block will be updated; any unspecified fields will remain unchanged.
Returns the complete updated portfolio record. This operation makes an HTTP PUT request to the
/portfolios/{portfolio\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Portfolio gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the portfolio.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Portfolios Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Project

`<asana:update-projects-by-project-gid>`

A specific, existing project can be updated by making a PUT request on the URL for that project.
Only the fields provided in the `data` block are updated; any unspecified fields remain unchanged.
When using this method, it is best to specify only those fields to change, or you may overwrite
changes made by another user since you last retrieved the task.

Returns the complete updated project record. This operation makes an HTTP PUT request to the
/projects/{project\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Project gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the project.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Projects Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Section

`<asana:update-sections-by-section-gid>`

A specific, existing section can be updated by making a PUT request on the URL for that project.
Only the fields provided in the `data` block will be updated; any unspecified fields will remain
unchanged. (note that at this time, the only field that can be updated is the `name` field.) When
using this method, it is best to specify only those fields you wish to change, or else you may
overwrite changes made by another user since you last retrieved the task. Returns the complete
updated section record. This operation makes an HTTP PUT request to the /sections/{section\_gid}
endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Section gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The globally unique identifier for the section.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Sections Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Story

`<asana:update-stories-by-story-gid>`

Updates the story and returns the full record for the updated story. Only comment stories can have
their text updated, and only comment stories and attachment stories can be pinned. Only one of
`text` and `html_text` can be specified. This operation makes an HTTP PUT request to the
/stories/{story\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Story gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the story.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Stories Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Tag

`<asana:update-tags-by-tag-gid>`

Updates the properties of a tag. Only the fields provided in the `data` block will be updated; any
unspecified fields will remain unchanged. When using this method, it is best to specify only those
fields you wish to change, or else you may overwrite changes made by another user since you last
retrieved the tag. Returns the complete updated tag record. This operation makes an HTTP PUT request
to the /tags/{tag\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Tag gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the tag.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>limit</p></td><td><div><div><p>Number</p></div></div></td><td><p>Results per page. The number of objects to return per page. The value must be between 1 and 100.</p></td><td></td><td></td></tr><tr><td><p>offset</p></td><td><div><div><p>String</p></div></div></td><td><p>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.'</p></td><td></td><td></td></tr><tr><td><p>output Mime Type</p></td><td><div><div><p>String</p></div></div></td><td><p>The mime type of the payload that this operation outputs.</p></td><td></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryIterable">Repeatable In Memory Iterable</a></p></li><li><p><a href="#RepeatableFileStoreIterable">Repeatable File Store Iterable</a></p></li><li><p>non-repeatable-iterable</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td><p>#[null]</p></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Array of Any</p></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Task

`<asana:update-tasks-by-task-gid>`

A specific, existing task can be updated by making a PUT request on the URL for that task. Only the
fields provided in the `data` block will be updated; any unspecified fields will remain unchanged.
When using this method, it is best to specify only those fields you wish to change, or else you may
overwrite changes made by another user since you last retrieved the task. Returns the complete
updated task record. This operation makes an HTTP PUT request to the /tasks/{task\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Task gid</p></td><td><div><div><p>String</p></div></div></td><td><p>The task to operate on.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Tasks Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Update Workspace

`<asana:update-workspaces-by-workspace-gid>`

A specific, existing workspace can be updated by making a PUT request on the URL for that workspace.
Only the fields provided in the data block will be updated; any unspecified fields will remain
unchanged. Currently the only field that can be modified for a workspace is its name. Returns the
complete, updated workspace record. This operation makes an HTTP PUT request to the
/workspaces/{workspace\_gid} endpoint.

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Workspace gid</p></td><td><div><div><p>String</p></div></div></td><td><p>Globally unique identifier for the workspace or organization.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Opt fields</p></td><td><div><div><p>Array of String</p></div></div></td><td><p>Defines fields to return. Some requests return <strong>compact</strong> representations of objects 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.</p></td><td></td><td></td></tr><tr><td><p>Workspaces Content</p></td><td><div><div><p>Any</p></div></div></td><td><p>the content to use</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Custom Query Parameters</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Custom Headers</p></td><td><div><div><p>Object</p></div></div></td><td></td><td></td><td></td></tr><tr><td><p>Response Timeout</p></td><td><div><div><p>Number</p></div></div></td><td><p>The timeout for request to the remote service.</p></td><td></td><td></td></tr><tr><td><p>Response Timeout Unit</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><p>A time unit that qualifies the Response Timeout}</p></td><td></td><td></td></tr><tr><td><p>Streaming Type</p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>AUTO</p></li><li><p>ALWAYS</p></li><li><p>NEVER</p></li></ul></div></div></td><td><p>Defines if the request should be sent using streaming. Setting the value to AUTO will automatically define the best strategy based on the request content.</p></td><td></td><td></td></tr><tr><td><p>Target Variable</p></td><td><div><div><p>String</p></div></div></td><td><p>Name of the variable that stores operation’s output.</p></td><td></td><td></td></tr><tr><td><p>Target Value</p></td><td><div><div><p>String</p></div></div></td><td><p>An expression to evaluate against the operation’s output and store the expression outcome in the target variable</p></td><td><p>#[payload]</p></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

### Throws

- ASANA:BAD\_REQUEST

- ASANA:CLIENT\_ERROR

- ASANA:CONNECTIVITY

- ASANA:INTERNAL\_SERVER\_ERROR

- ASANA:NOT\_ACCEPTABLE

- ASANA:NOT\_FOUND

- ASANA:RETRY\_EXHAUSTED

- ASANA:SERVER\_ERROR

- ASANA:SERVICE\_UNAVAILABLE

- ASANA:TIMEOUT

- ASANA:TOO\_MANY\_REQUESTS

- ASANA:UNAUTHORIZED

- ASANA:UNSUPPORTED\_MEDIA\_TYPE

## Sources

## On Updated Task Trigger

`<asana:on-updated-task-trigger>`

### Parameters

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p>Configuration</p></td><td><p>String</p></td><td><p>The name of the configuration to use.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Modified since</p></td><td><div><div><p>DateTime</p></div></div></td><td><p>Only return tasks that have been modified since the given time.</p><p>NOTE: A task is considered 'modified' if any of its properties change, or associations between it and other objects are modified (, for example a task being added to a project). A task is not considered modified just because another object it is associated with (, for example a subtask) is modified. Actions that count as modifying the task include assigning, renaming, completing, and adding stories.</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Assignee</p></td><td><div><div><p>String</p></div></div></td><td><p>The assignee to filter tasks on. <strong>Note: If you specify <code>assignee</code>, you must also specify the <code>workspace</code> to filter on.</strong></p></td><td></td><td></td></tr><tr><td><p>Workspace</p></td><td><div><div><p>String</p></div></div></td><td><p>The workspace to filter tasks on. <strong>Note: If you specify <code>workspace</code>, you must also specify the <code>assignee</code> to filter on.</strong></p></td><td></td><td></td></tr><tr><td><p>Project</p></td><td><div><div><p>String</p></div></div></td><td><p>The project to filter tasks on.</p></td><td></td><td></td></tr><tr><td><p>Section</p></td><td><div><div><p>String</p></div></div></td><td><p>The section to filter tasks on. <strong>Note: Currently, this is only supported in board views.</strong></p></td><td></td><td></td></tr><tr><td><p>Opt pretty</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Provides 'pretty'output. Provides the response in a 'pretty'format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.</p></td><td><p>false</p></td><td></td></tr><tr><td><p>Config Ref</p></td><td><div><div><p>ConfigurationProvider</p></div></div></td><td><p>The name of the configuration to use to execute this component</p></td><td></td><td></td></tr><tr><td><p>Primary Node Only</p></td><td><div><div><p>Boolean</p></div></div></td><td><p>Whether this source should only be executed on the primary node when running in a cluster</p></td><td></td><td></td></tr><tr><td><p>Scheduling Strategy</p></td><td><div><div><p>scheduling-strategy</p></div></div></td><td><p>Configures the scheduler that triggers the polling</p></td><td></td><td><p>x</p></td></tr><tr><td><p>Streaming Strategy</p></td><td><div><div><ul><li><p><a href="#RepeatableInMemoryStream">Repeatable In Memory Stream</a></p></li><li><p><a href="#RepeatableFileStoreStream">Repeatable File Store Stream</a></p></li><li><p>non-repeatable-stream</p></li></ul></div></div></td><td><p>Configure if repeatable streams should be used and their behavior</p></td><td></td><td></td></tr><tr><td><p>Redelivery Policy</p></td><td><div><div><p><a href="#RedeliveryPolicy">Redelivery Policy</a></p></div></div></td><td><p>Defines a policy for processing the redelivery of the same message</p></td><td></td><td></td></tr><tr><td><p>Reconnection Strategy</p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><p>A retry strategy in case of connectivity errors</p></td><td></td><td></td></tr></tbody></table>

### Output

<table><colgroup><col> <col></colgroup><tbody><tr><td><p>Type</p></td><td><p>Any</p></td></tr><tr><td><p>Attributes Type</p></td><td><div><div><p><a href="#HttpResponseAttributes">Http Response Attributes</a></p></div></div></td></tr></tbody></table>

### For Configurations

- [Configurations](#configurations)

## Types

### Default Header

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Key</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Value</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr></tbody></table>

### Default Query Param

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Key</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Value</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr></tbody></table>

### Proxy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Host</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Port</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Username</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Password</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Non Proxy Hosts</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Tls

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Enabled Protocols</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>A comma-separated list of protocols enabled for this context.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Enabled Cipher Suites</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>A comma-separated list of cipher suites enabled for this context.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Trust Store</strong></p></td><td><div><div><p><a href="#TrustStore">Trust Store</a></p></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Key Store</strong></p></td><td><div><div><p><a href="#KeyStore">Key Store</a></p></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Revocation Check</strong></p></td><td><div><div><ul><li><p><a href="#StandardRevocationCheck">Standard Revocation Check</a></p></li><li><p><a href="#CustomOcspResponder">Custom Ocsp Responder</a></p></li><li><p><a href="#CrlFile">Crl File</a></p></li></ul></div></div></td><td><div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Trust Store

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Path</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The location (which will be resolved relative to the current classpath and file system, if possible) of the trust store.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Password</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The password used to protect the trust store.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Type</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The type of store used.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Algorithm</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The algorithm used by the trust store.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Insecure</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Key Store

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Path</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The location (which will be resolved relative to the current classpath and file system, if possible) of the key store.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Type</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The type of store used.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Alias</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>When the key store contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Key Password</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The password used to protect the private key.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Password</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The password used to protect the key store.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Algorithm</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The algorithm used by the key store.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Standard Revocation Check

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Only End Entities</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>Only verify the last element of the certificate chain.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Prefer Crls</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>Try CRL instead of OCSP first.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>No Fallback</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>Do not use the secondary checking method (the one not selected before).</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Soft Fail</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>Avoid verification failure when the revocation server can not be reached or is busy.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Custom Ocsp Responder

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Url</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The URL of the OCSP responder.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Cert Alias</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>Alias of the signing certificate for the OCSP response (must be in the trust store), if present.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Crl File

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Path</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The path to the CRL file.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Reconnection

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Fails Deployment</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Reconnection Strategy</strong></p></td><td><div><div><ul><li><p><a href="#Reconnect">Reconnect</a></p></li><li><p><a href="#ReconnectForever">Reconnect Forever</a></p></li></ul></div></div></td><td><div><div><p>The reconnection strategy to use.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Reconnect

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often in milliseconds to reconnect</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Blocking</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>If false, the reconnection strategy will run in a separate, non-blocking thread</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Count</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How many reconnection attempts to make.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Reconnect Forever

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Frequency</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>How often in milliseconds to reconnect</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Blocking</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>If false, the reconnection strategy will run in a separate, non-blocking thread</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Expiration Policy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Max Idle Time</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Time Unit</strong></p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>NANOSECONDS</p></li><li><p>MICROSECONDS</p></li><li><p>MILLISECONDS</p></li><li><p>SECONDS</p></li><li><p>MINUTES</p></li><li><p>HOURS</p></li><li><p>DAYS</p></li></ul></div></div></td><td><div><div><p>A time unit that qualifies the maxIdleTime attribute</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Http Response Attributes

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Status Code</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Headers</strong></p></td><td><div><div><p>Object</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr><tr><td><p><strong>Reason Phrase</strong></p></td><td><div><div><p>String</p></div></div></td><td><div></div></td><td><div></div></td><td><div><div><p>x</p></div></div></td></tr></tbody></table>

### Repeatable In Memory Stream

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Initial Buffer Size</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The amount of memory that will be allocated to consume the stream and provide random access to it. If the stream contains more data than can be fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Buffer Size Increment</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Max Buffer Size</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Buffer Unit</strong></p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>BYTE</p></li><li><p>KB</p></li><li><p>MB</p></li><li><p>GB</p></li></ul></div></div></td><td><div><div><p>The unit in which all these attributes are expressed</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Repeatable File Store Stream

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>In Memory Size</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed content on the disk is buffered.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Buffer Unit</strong></p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>BYTE</p></li><li><p>KB</p></li><li><p>MB</p></li><li><p>GB</p></li></ul></div></div></td><td><div><div><p>The unit in which maxInMemorySize is expressed</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Redelivery Policy

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Max Redelivery Count</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The maximum number of times a message can be redelivered and processed unsuccessfully before triggering process-failed-message</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Message Digest Algorithm</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>The secure hashing algorithm to use. If not set, the default is SHA-256.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Message Identifier</strong></p></td><td><div><div><p><a href="#RedeliveryPolicyMessageIdentifier">Redelivery Policy Message Identifier</a></p></div></div></td><td><div><div><p>Defines which strategy is used to identify the messages.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Object Store</strong></p></td><td><div><div><p>ObjectStore</p></div></div></td><td><div><div><p>The object store where the redelivery counter for each message is stored.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Redelivery Policy Message Identifier

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Use Secure Hash</strong></p></td><td><div><div><p>Boolean</p></div></div></td><td><div><div><p>Whether to use a secure hash algorithm to identify a redelivered message.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Id Expression</strong></p></td><td><div><div><p>String</p></div></div></td><td><div><div><p>Defines one or more expressions to use to determine when a message has been redelivered. This property may only be set if useSecureHash is false.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Repeatable In Memory Iterable

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>Initial Buffer Size</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The number of instances to initially keep in memory to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize. Default value is 100 instances.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Buffer Size Increment</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full. Default value is 100 instances.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Max Buffer Size</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>

### Repeatable File Store Iterable

<table><colgroup><col> <col> <col> <col> <col></colgroup><thead><tr><th>Field</th><th>Type</th><th>Description</th><th>Default Value</th><th>Required</th></tr></thead><tbody><tr><td><p><strong>In Memory Objects</strong></p></td><td><div><div><p>Number</p></div></div></td><td><div><div><p>The maximum amount of instances to keep in memory. If more than that is required, content on the disk is buffered.</p></div></div></td><td><div></div></td><td><div></div></td></tr><tr><td><p><strong>Buffer Unit</strong></p></td><td><div><div><p>Enumeration, one of:</p></div><div><ul><li><p>BYTE</p></li><li><p>KB</p></li><li><p>MB</p></li><li><p>GB</p></li></ul></div></div></td><td><div><div><p>The unit in which maxInMemorySize is expressed</p></div></div></td><td><div></div></td><td><div></div></td></tr></tbody></table>
