Documentation Index

Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt

Use this file to discover all available pages before exploring further.

Asana Connector

Prev Next
Note on third‑party tools

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

Asana is a web and mobile application designed to help teams organize, track, and manage their work.

Use the Asana component to manage users, projects, and teams in an Asana workspace.

Connections

OAuth 2.0

Authenticate using OAuth 2.0.

To connect to Asana using OAuth 2.0, create an OAuth application within Asana's developer portal. This allows users to authenticate with their Asana credentials.

Prerequisites

  • An active Asana account
  • Permissions to create OAuth applications in Asana

Setup Steps

  1. Log in to Asana and navigate to app.asana.com/0/my-apps
  2. Click Create new app
  3. Enter a name for the application and agree to Asana's terms and conditions
  4. Open OAuth from the left-hand menu
  5. Click + Add redirect URL and enter the OAuth callback URL: https://oauth2.flowbuilder.eu.lansweeper.com/callback for EU sites or https://oauth2.flowbuilder.us.lansweeper.com/callback for US sites
  6. Copy the generated Client ID and Client secret values

Configure the Connection

  • Enter the Client ID and Client secret from the OAuth application
  • For Scopes, specify the required permissions using the format <resource>:<action>:

Recommended Scopes

Scope Description
default Basic access to user identity and workspace membership
tasks:read Read tasks, subtasks, and task details
tasks:write Create, update, and delete tasks
projects:read Read projects and project details
projects:write Create, update, and delete projects
users:read Read user profiles and team membership
workspaces:read Read workspace and organization details
attachments:read Read file attachments on tasks
attachments:write Upload and manage attachments
webhooks:read Read webhook subscriptions
webhooks:write Create and manage webhooks

Example scope configurations:

  • Read-only access: default tasks:read projects:read users:read workspaces:read
  • Task management: default tasks:read tasks:write projects:read users:read
  • Full project access: default tasks:read tasks:write projects:read projects:write users:read workspaces:read
  • Webhook-enabled: default tasks:read projects:read webhooks:read webhooks:write

This connection uses OAuth 2.0, a common authentication mechanism for integrations.
Read about how OAuth 2.0 works here.

Input Comments Default
Scopes A space-separated list of OAuth scopes using the format <resource>:<action> (e.g., tasks:read, projects:write). Leave blank for full access. See Asana OAuth scopes for available values.
Client ID The OAuth 2.0 client ID. Generate one from the Asana Developer Portal.
Client Secret The OAuth 2.0 client secret. Generate one from the Asana Developer Portal.

Personal Access Token

Authenticate requests using an Asana Personal Access Token.

A personal access token can be used for development and testing purposes. For production deployments, use the OAuth 2.0 connection to allow users to authenticate with their own Asana credentials.

Prerequisites

  • An active Asana account with permissions to create personal access tokens

Setup Steps

To generate a personal access token:

  1. Log in to Asana and navigate to app.asana.com/0/my-apps
  2. Click + Create new token
  3. Enter a description for the token and click Create token
  4. Copy the generated token value
Security Note

Personal access tokens are tied to the user account that created them and inherit that user's permissions. Store tokens securely and rotate them regularly.

Configure the Connection

  • Enter the Personal Access Token value into the connection configuration

For more information on personal access tokens, refer to the Asana Docs.

Input Comments Default
Personal Access Token The Asana Personal Access Token. Generate one from the Asana Developer Portal.

Triggers

Comments and Activity

Receive comment and activity notifications from Asana. Automatically creates and manages a webhook subscription for story events in the selected project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Trigger When Added Determines if the webhook will trigger when a comment or activity is added. true
Trigger When Changed Determines if the webhook will trigger when a comment or activity is changed. true
Trigger When Deleted Determines if the webhook will trigger when a comment or activity is deleted. true
Trigger When Removed Determines if the webhook will trigger when a comment or activity is removed. true
Trigger When Undeleted Determines if the webhook will trigger when a comment or activity is undeleted. true

New and Updated Tasks

Checks for new and updated tasks in a selected Asana project on a configured schedule.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Show New Records When true, tasks created since the last poll are returned in the trigger payload. true
Show Updated Records When true, tasks modified since the last poll are returned in the trigger payload. true

Project Tasks

Receive task notifications from Asana. Automatically creates and manages a webhook subscription for task events in the selected project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Trigger When Added Determines if the webhook will trigger when a task is added. true
Trigger When Changed Determines if the webhook will trigger when a task is changed. true
Trigger When Deleted Determines if the webhook will trigger when a task is deleted. true
Trigger When Removed Determines if the webhook will trigger when a task is removed. true
Trigger When Undeleted Determines if the webhook will trigger when a task is undeleted. true

Webhook

Receive and validate webhook requests from Asana for manually configured webhook subscriptions.

Workspace Projects

Receive project notifications from Asana. Automatically creates and manages a webhook subscription for project events in the selected workspace.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Trigger When Added Determines if the webhook will trigger when a project is added. true
Trigger When Changed Determines if the webhook will trigger when a project is changed. true
Trigger When Deleted Determines if the webhook will trigger when a project is deleted. true
Trigger When Removed Determines if the webhook will trigger when a project is removed. true
Trigger When Undeleted Determines if the webhook will trigger when a project is undeleted. true

Actions

Add Custom Field to Portfolio

Add a custom field to an existing portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Field ID The unique identifier for the custom field.
Insert After The gid of a sibling field or section after which the new item will be inserted.
Insert Before The gid of a sibling field or section before which the new item will be inserted.
Is Important When true, the custom field is highlighted as important and displayed prominently in the Asana UI. true

Add Custom Field to Project

Add a new custom field to an existing project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Field ID The unique identifier for the custom field.
Insert After The gid of a sibling field or section after which the new item will be inserted.
Insert Before The gid of a sibling field or section before which the new item will be inserted.
Is Important When true, the custom field is highlighted as important and displayed prominently in the Asana UI. true

Add Followers to Task

Add followers to an existing task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Followers List A list of user gids to add as followers. Provide one user ID per entry.

Add Tag to Task

Add a tag to an existing task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Tag ID The unique identifier for the tag.

Add Task to Section

Add an existing task to the given section of a project.

Input Comments Default
Connection The Asana connection to use.
Section ID The unique identifier for the section.
Task ID The unique identifier for the task.
Insert After The gid of a sibling field or section after which the new item will be inserted.
Insert Before The gid of a sibling field or section before which the new item will be inserted.

Add Users to Portfolio

Add existing users to the given portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Members A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.

Add Users to Project

Add existing users to the given project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Members A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.

Add User to Team

Add an existing user to the given team.

Input Comments Default
Team ID The unique identifier for the team.
User ID The unique identifier for the user.
Connection The Asana connection to use.

Add User to Workspace

Add a new user to the given workspace.

Input Comments Default
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
User ID The unique identifier for the user.
Connection The Asana connection to use.

Attach File to Task

Attach a file to a task.

Input Comments Default
Connection The Asana connection to use.
File File to attach. This should be a reference to a previous step
File Name Name of the file to attach
Task ID The unique identifier for the task.

Create Portfolio

Create a new portfolio.

Input Comments Default
Connection The Asana connection to use.
Color The display color associated with the object in the Asana UI. light-green
Members A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.
Portfolio Name The display name for the portfolio.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Public When true, the resource is visible to every member of the team it belongs to. false

Create Project

Create a new project inside an existing team or organization.

Input Comments Default
Connection The Asana connection to use.
Owner ID The unique identifier of the user who will own the project. The owner has full administrative rights over the project.
Project Color The display color associated with the project in the Asana UI. light-green
Default View The default view to display when opening the project in Asana. list
Privacy Setting The privacy setting of the project. Administrators in the organization may restrict these values.
Due On The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.
Archived When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries. false
Followers A comma-separated list of user gids to add as followers of the resource.
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
HTML Notes The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
Start On The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Workspace ID Include this value if you would like this project to be included in a workspace.
Team ID The team that this project is shared with. Only exists for projects in organizations — including this field for non-organization projects causes the request to fail.

Create Section

Create a new section within a project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Connection The Asana connection to use.
Insert After The gid of a sibling field or section after which the new item will be inserted.
Insert Before The gid of a sibling field or section before which the new item will be inserted.
Section Name The display name for the section.

Create Status Update

Create a status update on a project, portfolio, or goal.

Input Comments Default
Connection The Asana connection to use.
Project, Portfolio, or Goal ID The unique identifier for the parent project, portfolio, or goal the status update belongs to.
Status Title The title of the project status update.
Status Text The text content of the status update.
This represents the current state of the object on_track
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

Create Tag

Create a new tag in a workspace.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Followers List A list of user gids to add as followers. Provide one user ID per entry.
Color The display color associated with the object in the Asana UI. light-green
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.

Create Task

Create a new task inside a workspace or organization.

Input Comments Default
Connection The Asana connection to use.
Approval Status The approval status to set on the task.
Completed Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Completed By The name of the user who completed the task. A user gid or email address may also be provided to reference an existing Asana user.
Assignee ID The unique identifier of the user assigned to the task.
Assignee Section ID The unique identifier for the section to assign the task to. The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list.
Assignee Status The status the task has in relation to its assignee. This field is deprecated — it can still be used in requests but is not recommended for new records.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Start On The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Start At The date and time work begins for the task, or null if the task has no start time. Format: ISO 8601 in UTC. Should not be used together with Start On. Due At must be present when setting or unsetting this parameter.
HTML Notes The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Resource Subtype The subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.
Project List A list of project gids the task should belong to. Provide one project ID per entry.
Parent ID The unique identifier of the parent element.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Is Liked Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Followers List A list of user gids to add as followers. Provide one user ID per entry.
Due At The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.
Due On The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.

Create Team

Create a new team within an organization.

Input Comments Default
Description Free-form description of the team's purpose, shown on the team page in Asana.
Name The display name for the team.
Organization or Workspace ID The unique identifier for the organization or workspace.
Connection The Asana connection to use.

Create Webhook

Create a webhook to send data from Asana to an instance URL.

Input Comments Default
Webhook URL Reference a flow's URL from the trigger payload
Resource ID The GID of a project, portfolio, goal, task, etc - the resource to listen for
Filter The filter parameters for the webhook expressed as a JSON array. See the Asana webhooks guide for available filter options. [
{
"action": "changed",
"fields": [
"due_at",
"due_on",
"dependencies"
],
"resource_subtype": "milestone",
"resource_type": "task"
}
]
Connection The Asana connection to use.

Delete Attachment

Delete an existing attachment.

Input Comments Default
Connection The Asana connection to use.
Attachment ID The unique identifier for the attachment.

Delete Instance Webhooks

Delete all Asana webhooks that point to a flow in this instance.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

Delete Portfolio

Delete an existing portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.

Delete Project

Delete an existing project by ID.

Input Comments Default
Project ID The unique identifier for the project.
Connection The Asana connection to use.

Delete Section

Delete an existing section.

Input Comments Default
Connection The Asana connection to use.
Section ID The unique identifier for the section.

Delete Status Update

Delete an existing status update.

Input Comments Default
Connection The Asana connection to use.
Status ID The unique identifier for the status update.

Delete Tag

Delete an existing tag.

Input Comments Default
Connection The Asana connection to use.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.
Tag ID The unique identifier for the tag.

Delete Task

Delete an existing task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.

Delete Webhook

Delete an existing webhook by ID.

Input Comments Default
Connection The Asana connection to use.
Webhook ID The gid of the workspace

Find Tag by Name

Find a tag by name within a workspace.

Input Comments Default
Connection The Asana connection to use.
Tag Name Note: if multiple tags share a name, only one tag will be returned.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

Find Team by Name

Find a team by name within a workspace.

Input Comments Default
Connection The Asana connection to use.
Team Name Note: if multiple teams share a name, only one team will be returned.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

Find User by Name or Email

Find a user by name or email address within a workspace.

Input Comments Default
Connection The Asana connection to use.
User's Full Name Note: if multiple users share a name, only one user will be returned.
User's Email Note: if multiple users share an email address, only one user will be returned.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

Find Workspace by Name

Find a workspace by name.

Input Comments Default
Connection The Asana connection to use.
Workspace Name

Get Attachment

Get the information and metadata of an attachment.

Input Comments Default
Connection The Asana connection to use.
Attachment ID The unique identifier for the attachment.

Get Current User

Get information about the currently authenticated user.

Input Comments Default
Connection The Asana connection to use.

Get Custom Field

Get the information and metadata of a custom field.

Input Comments Default
Connection The Asana connection to use.
Field ID The unique identifier for the custom field.

Get Portfolio

Get the information and metadata of a portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.

Get Project

Get the information and metadata of a project by ID.

Input Comments Default
Project ID The unique identifier for the project.
Connection The Asana connection to use.

Get Section

Get the information and metadata of a section.

Input Comments Default
Connection The Asana connection to use.
Section ID The unique identifier for the section.

Get Status Update

Get the information and metadata of a status update.

Input Comments Default
Connection The Asana connection to use.
Status ID The unique identifier for the status update.

Get Status Updates from Object

Get status updates from a project, portfolio, or goal.

Input Comments Default
Connection The Asana connection to use.
Project, Portfolio, or Goal ID The unique identifier for the parent project, portfolio, or goal the status update belongs to.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

Get Tag

Get the information and metadata of a tag.

Input Comments Default
Connection The Asana connection to use.
Tag ID The unique identifier for the tag.

Get Task

Get the information and metadata of a task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.

Get Team

Get the information and metadata of a team.

Input Comments Default
Connection The Asana connection to use.
Team ID The unique identifier for the team.

Get User

Get the information and metadata of a user.

Input Comments Default
User ID The unique identifier for the user.
Connection The Asana connection to use.

Get Workspace

Get the information and metadata of the given workspace.

Input Comments Default
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Connection The Asana connection to use.

List Custom Fields

List all custom fields in a workspace.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Portfolio Items

List all items in a given portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Offset The pagination offset token returned from a previous query that had a next_page property.
Limit The maximum number of items to return per page (between 1 and 100).

List Portfolios

List portfolios that the authenticated user owns.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Projects

List all projects accessible to the authenticated user.

Input Comments Default
Connection The Asana connection to use.
Offset The pagination offset token returned from a previous query that had a next_page property.
Limit The maximum number of items to return per page (between 1 and 100).
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

List Sections

List all sections in a given project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Offset The pagination offset token returned from a previous query that had a next_page property.
Limit The maximum number of items to return per page (between 1 and 100).

List Subtasks

List all subtasks within a given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.
List All Nested Subtasks When true, recursively lists subtasks of subtasks rather than only direct subtasks of the parent task. false

List Tags

List all tags accessible to the authenticated user.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Tags in Task

List all tags applied to a given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Task Attachments

List all attachments in a given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Tasks

List tasks within a workspace, project, or assignee scope.

Input Comments Default
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Assignee ID The unique identifier of the user assigned to the task.
Project ID The unique identifier for the project.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.
Connection The Asana connection to use.

List Teams

List all teams within a given workspace.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.

List Users

List all users accessible to the authenticated user.

Input Comments Default
Workspace ID Optionally filter by workspace ID
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.
Connection The Asana connection to use.

List Workspaces

List all workspaces accessible to the authenticated user.

Input Comments Default
Connection The Asana connection to use.
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

List Workspace Webhooks

List all webhooks configured in Asana, including those for other integrations.

Input Comments Default
Connection The Asana connection to use.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Show only instance webhooks Show only webhooks that point to this instance true
Limit The maximum number of items to return per page (between 1 and 100).
Offset The pagination offset token returned from a previous query that had a next_page property.

Raw Request

Send a raw HTTP request to Asana.

Input Comments Default
Connection The Asana connection to use.
URL Input the path only (/goals), The base URL is already included (https://app.asana.com/api/1.0). For example, to connect to https://app.asana.com/api/1.0/goals, only /goals is entered in this field.
Method The HTTP method to use.
Data The HTTP body payload to send to the URL.
Form Data The Form Data to be sent as a multipart form upload.
File Data File Data to be sent as a multipart form upload.
File Data File Names File names to apply to the file data inputs. Keys must match the file data keys above.
Query Parameter A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.
Header A list of headers to send with the request.
Response Type The type of data you expect in the response. You can request json, text, or binary data. json
Timeout The maximum time that a client will await a response to its request
Retry Delay (ms) The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. 0
Retry On All Errors If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. false
Max Retry Count The maximum number of retries to attempt. Specify 0 for no retries. 0
Use Exponential Backoff Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. false

Remove Assignee from Task

Remove the assignee from the given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.

Remove Custom Field from Portfolio

Remove a custom field from an existing portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Field ID The unique identifier for the custom field.

Remove Custom Field from Project

Remove an existing custom field from an existing project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Field ID The unique identifier for the custom field.

Remove Followers from Task

Remove followers from the given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Followers List A list of user gids to add as followers. Provide one user ID per entry.

Remove Portfolio Item

Remove an existing item from the given portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Item ID The unique identifier for the item (a project or portfolio).

Remove Tag from Task

Remove a tag from the given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Tag ID The unique identifier for the tag.

Remove Users from Portfolio

Remove existing users from the given portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Members A list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.

Update Portfolio

Update the information and metadata of the given portfolio.

Input Comments Default
Connection The Asana connection to use.
Portfolio ID The unique identifier for the portfolio.
Color The display color associated with the object in the Asana UI. light-green
Portfolio Name The display name for the portfolio.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Public When true, the resource is visible to every member of the team it belongs to. false

Update Project

Update the information and metadata of a project.

Input Comments Default
Connection The Asana connection to use.
Project ID The unique identifier for the project.
Project Color The display color associated with the project in the Asana UI. light-green
Default View The default view to display when opening the project in Asana.
Privacy Setting The privacy setting of the project. Administrators in the organization may restrict these values.
Due On The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.
Archived When true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries. false
Followers A comma-separated list of user gids to add as followers of the resource.
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
HTML Notes The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Owner ID The unique identifier of the user who will own the project. The owner has full administrative rights over the project.
Start On The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Team ID The team that this project is shared with. Only exists for projects in organizations — including this field for non-organization projects causes the request to fail.

Update Section

Update the information and metadata of a project section.

Input Comments Default
Connection The Asana connection to use.
Section ID The unique identifier for the section.
Section Name The display name for the section.
Insert After The gid of a sibling field or section after which the new item will be inserted.
Insert Before The gid of a sibling field or section before which the new item will be inserted.

Update Tag

Update the information and metadata of the given tag.

Input Comments Default
Connection The Asana connection to use.
Tag ID The unique identifier for the tag.
Color The display color associated with the object in the Asana UI. light-green
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.

Update Task

Update the information and metadata of the given task.

Input Comments Default
Connection The Asana connection to use.
Task ID The unique identifier for the task.
Approval Status The approval status to set on the task.
Completed Whether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Completed By The name of the user who completed the task. A user gid or email address may also be provided to reference an existing Asana user.
Assignee ID The unique identifier of the user assigned to the task.
Assignee Section ID The unique identifier for the section to assign the task to. The assignee section is a subdivision of a project that groups tasks together in the assignee's 'My Tasks' list.
Assignee Status The status the task has in relation to its assignee. This field is deprecated — it can still be used in requests but is not recommended for new records.
Workspace ID The unique identifier for the workspace. Required when the account has multiple workspaces.
Start At The date and time work begins for the task, or null if the task has no start time. Format: ISO 8601 in UTC. Should not be used together with Start On. Due At must be present when setting or unsetting this parameter.
Start On The date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Resource Subtype The subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.
Parent ID The unique identifier of the parent element.
HTML Notes The rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Notes Free-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
Name The display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Is Liked Whether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Due At The date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.
Due On The date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.