Skip to main content

Asana Connector

Asana 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.integrations.acme.com/callback
  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>:
ScopeDescription
defaultBasic access to user identity and workspace membership
tasks:readRead tasks, subtasks, and task details
tasks:writeCreate, update, and delete tasks
projects:readRead projects and project details
projects:writeCreate, update, and delete projects
users:readRead user profiles and team membership
workspaces:readRead workspace and organization details
attachments:readRead file attachments on tasks
attachments:writeUpload and manage attachments
webhooks:readRead webhook subscriptions
webhooks:writeCreate 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.

InputCommentsDefault
ScopesA 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 IDThe OAuth 2.0 client ID. Generate one from the Asana Developer Portal.
Client SecretThe 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.

InputCommentsDefault
Personal Access TokenThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Trigger When AddedDetermines if the webhook will trigger when a comment or activity is added.true
Trigger When ChangedDetermines if the webhook will trigger when a comment or activity is changed.true
Trigger When DeletedDetermines if the webhook will trigger when a comment or activity is deleted.true
Trigger When RemovedDetermines if the webhook will trigger when a comment or activity is removed.true
Trigger When UndeletedDetermines 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Show New RecordsWhen true, tasks created since the last poll are returned in the trigger payload.true
Show Updated RecordsWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Trigger When AddedDetermines if the webhook will trigger when a task is added.true
Trigger When ChangedDetermines if the webhook will trigger when a task is changed.true
Trigger When DeletedDetermines if the webhook will trigger when a task is deleted.true
Trigger When RemovedDetermines if the webhook will trigger when a task is removed.true
Trigger When UndeletedDetermines 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Trigger When AddedDetermines if the webhook will trigger when a project is added.true
Trigger When ChangedDetermines if the webhook will trigger when a project is changed.true
Trigger When DeletedDetermines if the webhook will trigger when a project is deleted.true
Trigger When RemovedDetermines if the webhook will trigger when a project is removed.true
Trigger When UndeletedDetermines 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
Field IDThe unique identifier for the custom field.
Insert AfterThe gid of a sibling field or section after which the new item will be inserted.
Insert BeforeThe gid of a sibling field or section before which the new item will be inserted.
Is ImportantWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Field IDThe unique identifier for the custom field.
Insert AfterThe gid of a sibling field or section after which the new item will be inserted.
Insert BeforeThe gid of a sibling field or section before which the new item will be inserted.
Is ImportantWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
Followers ListA 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
Tag IDThe unique identifier for the tag.

Add Task to Section

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

InputCommentsDefault
ConnectionThe Asana connection to use.
Section IDThe unique identifier for the section.
Task IDThe unique identifier for the task.
Insert AfterThe gid of a sibling field or section after which the new item will be inserted.
Insert BeforeThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
MembersA 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
MembersA 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.

InputCommentsDefault
Team IDThe unique identifier for the team.
User IDThe unique identifier for the user.
ConnectionThe Asana connection to use.

Add User to Workspace

Add a new user to the given workspace.

InputCommentsDefault
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
User IDThe unique identifier for the user.
ConnectionThe Asana connection to use.

Attach File to Task

Attach a file to a task.

InputCommentsDefault
ConnectionThe Asana connection to use.
FileFile to attach. This should be a reference to a previous step
File NameName of the file to attach
Task IDThe unique identifier for the task.

Create Portfolio

Create a new portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
ColorThe display color associated with the object in the Asana UI.light-green
MembersA list of users to add as members. Each value can be the string 'me', an email address, or the gid of a user.
Portfolio NameThe display name for the portfolio.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
PublicWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Owner IDThe unique identifier of the user who will own the project. The owner has full administrative rights over the project.
Project ColorThe display color associated with the project in the Asana UI.light-green
Default ViewThe default view to display when opening the project in Asana.list
Privacy SettingThe privacy setting of the project. Administrators in the organization may restrict these values.
Due OnThe date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.
ArchivedWhen true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries.false
FollowersA comma-separated list of user gids to add as followers of the resource.
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
HTML NotesThe rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
NotesFree-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
Start OnThe date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Workspace IDInclude this value if you would like this project to be included in a workspace.
Team IDThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
ConnectionThe Asana connection to use.
Insert AfterThe gid of a sibling field or section after which the new item will be inserted.
Insert BeforeThe gid of a sibling field or section before which the new item will be inserted.
Section NameThe display name for the section.

Create Status Update

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

InputCommentsDefault
ConnectionThe Asana connection to use.
Project, Portfolio, or Goal IDThe unique identifier for the parent project, portfolio, or goal the status update belongs to.
Status TitleThe title of the project status update.
Status TextThe text content of the status update.
This represents the current state of the objecton_track
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

Create Tag

Create a new tag in a workspace.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Followers ListA list of user gids to add as followers. Provide one user ID per entry.
ColorThe display color associated with the object in the Asana UI.light-green
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
NotesFree-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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Approval StatusThe approval status to set on the task.
CompletedWhether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Completed ByThe 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 IDThe unique identifier of the user assigned to the task.
Assignee Section IDThe 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 StatusThe 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 IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Start OnThe date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Start AtThe 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 NotesThe rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Resource SubtypeThe subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.
Project ListA list of project gids the task should belong to. Provide one project ID per entry.
Parent IDThe unique identifier of the parent element.
NotesFree-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Is LikedWhether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Followers ListA list of user gids to add as followers. Provide one user ID per entry.
Due AtThe date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.
Due OnThe 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.

InputCommentsDefault
DescriptionFree-form description of the team's purpose, shown on the team page in Asana.
NameThe display name for the team.
Organization or Workspace IDThe unique identifier for the organization or workspace.
ConnectionThe Asana connection to use.

Create Webhook

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

InputCommentsDefault
Webhook URLReference a flow's URL from the trigger payload
Resource IDThe GID of a project, portfolio, goal, task, etc - the resource to listen for
FilterThe 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"
}
]
ConnectionThe Asana connection to use.

Delete Attachment

Delete an existing attachment.

InputCommentsDefault
ConnectionThe Asana connection to use.
Attachment IDThe unique identifier for the attachment.

Delete Instance Webhooks

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

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.

Delete Portfolio

Delete an existing portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.

Delete Project

Delete an existing project by ID.

InputCommentsDefault
Project IDThe unique identifier for the project.
ConnectionThe Asana connection to use.

Delete Section

Delete an existing section.

InputCommentsDefault
ConnectionThe Asana connection to use.
Section IDThe unique identifier for the section.

Delete Status Update

Delete an existing status update.

InputCommentsDefault
ConnectionThe Asana connection to use.
Status IDThe unique identifier for the status update.

Delete Tag

Delete an existing tag.

InputCommentsDefault
ConnectionThe Asana connection to use.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.
Tag IDThe unique identifier for the tag.

Delete Task

Delete an existing task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.

Delete Webhook

Delete an existing webhook by ID.

InputCommentsDefault
ConnectionThe Asana connection to use.
Webhook IDThe gid of the workspace

Find Tag by Name

Find a tag by name within a workspace.

InputCommentsDefault
ConnectionThe Asana connection to use.
Tag NameNote: if multiple tags share a name, only one tag will be returned.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.

Find Team by Name

Find a team by name within a workspace.

InputCommentsDefault
ConnectionThe Asana connection to use.
Team NameNote: if multiple teams share a name, only one team will be returned.
Workspace IDThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
User's Full NameNote: if multiple users share a name, only one user will be returned.
User's EmailNote: if multiple users share an email address, only one user will be returned.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.

Find Workspace by Name

Find a workspace by name.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace Name

Get Attachment

Get the information and metadata of an attachment.

InputCommentsDefault
ConnectionThe Asana connection to use.
Attachment IDThe unique identifier for the attachment.

Get Current User

Get information about the currently authenticated user.

InputCommentsDefault
ConnectionThe Asana connection to use.

Get Custom Field

Get the information and metadata of a custom field.

InputCommentsDefault
ConnectionThe Asana connection to use.
Field IDThe unique identifier for the custom field.

Get Portfolio

Get the information and metadata of a portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.

Get Project

Get the information and metadata of a project by ID.

InputCommentsDefault
Project IDThe unique identifier for the project.
ConnectionThe Asana connection to use.

Get Section

Get the information and metadata of a section.

InputCommentsDefault
ConnectionThe Asana connection to use.
Section IDThe unique identifier for the section.

Get Status Update

Get the information and metadata of a status update.

InputCommentsDefault
ConnectionThe Asana connection to use.
Status IDThe unique identifier for the status update.

Get Status Updates from Object

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

InputCommentsDefault
ConnectionThe Asana connection to use.
Project, Portfolio, or Goal IDThe unique identifier for the parent project, portfolio, or goal the status update belongs to.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

Get Tag

Get the information and metadata of a tag.

InputCommentsDefault
ConnectionThe Asana connection to use.
Tag IDThe unique identifier for the tag.

Get Task

Get the information and metadata of a task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.

Get Team

Get the information and metadata of a team.

InputCommentsDefault
ConnectionThe Asana connection to use.
Team IDThe unique identifier for the team.

Get User

Get the information and metadata of a user.

InputCommentsDefault
User IDThe unique identifier for the user.
ConnectionThe Asana connection to use.

Get Workspace

Get the information and metadata of the given workspace.

InputCommentsDefault
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
ConnectionThe Asana connection to use.

List Custom Fields

List all custom fields in a workspace.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

List Portfolio Items

List all items in a given portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
OffsetThe pagination offset token returned from a previous query that had a next_page property.
LimitThe maximum number of items to return per page (between 1 and 100).

List Portfolios

List portfolios that the authenticated user owns.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

List Projects

List all projects accessible to the authenticated user.

InputCommentsDefault
ConnectionThe Asana connection to use.
OffsetThe pagination offset token returned from a previous query that had a next_page property.
LimitThe maximum number of items to return per page (between 1 and 100).
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.

List Sections

List all sections in a given project.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
OffsetThe pagination offset token returned from a previous query that had a next_page property.
LimitThe maximum number of items to return per page (between 1 and 100).

List Subtasks

List all subtasks within a given task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.
List All Nested SubtasksWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

List Task Attachments

List all attachments in a given task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe 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.

InputCommentsDefault
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Assignee IDThe unique identifier of the user assigned to the task.
Project IDThe unique identifier for the project.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.
ConnectionThe Asana connection to use.

List Teams

List all teams within a given workspace.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.

List Users

List all users accessible to the authenticated user.

InputCommentsDefault
Workspace IDOptionally filter by workspace ID
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.
ConnectionThe Asana connection to use.

List Workspaces

List all workspaces accessible to the authenticated user.

InputCommentsDefault
ConnectionThe Asana connection to use.
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Show only instance webhooksShow only webhooks that point to this instancetrue
LimitThe maximum number of items to return per page (between 1 and 100).
OffsetThe pagination offset token returned from a previous query that had a next_page property.

Raw Request

Send a raw HTTP request to Asana.

InputCommentsDefault
ConnectionThe Asana connection to use.
URLInput 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.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA 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.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe 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 ErrorsIf 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 CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.

Remove Custom Field from Portfolio

Remove a custom field from an existing portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
Field IDThe unique identifier for the custom field.

Remove Custom Field from Project

Remove an existing custom field from an existing project.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Field IDThe unique identifier for the custom field.

Remove Followers from Task

Remove followers from the given task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
Followers ListA 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
Item IDThe unique identifier for the item (a project or portfolio).

Remove Tag from Task

Remove a tag from the given task.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
Tag IDThe unique identifier for the tag.

Remove Users from Portfolio

Remove existing users from the given portfolio.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
MembersA 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Portfolio IDThe unique identifier for the portfolio.
ColorThe display color associated with the object in the Asana UI.light-green
Portfolio NameThe display name for the portfolio.
Workspace IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
PublicWhen 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Project IDThe unique identifier for the project.
Project ColorThe display color associated with the project in the Asana UI.light-green
Default ViewThe default view to display when opening the project in Asana.
Privacy SettingThe privacy setting of the project. Administrators in the organization may restrict these values.
Due OnThe date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.
ArchivedWhen true, the project is archived and hidden from the UI by default. Archived projects may be treated differently for queries.false
FollowersA comma-separated list of user gids to add as followers of the resource.
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
NotesFree-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
HTML NotesThe rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
Owner IDThe unique identifier of the user who will own the project. The owner has full administrative rights over the project.
Start OnThe date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Team IDThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Section IDThe unique identifier for the section.
Section NameThe display name for the section.
Insert AfterThe gid of a sibling field or section after which the new item will be inserted.
Insert BeforeThe 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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Tag IDThe unique identifier for the tag.
ColorThe display color associated with the object in the Asana UI.light-green
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
NotesFree-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.

InputCommentsDefault
ConnectionThe Asana connection to use.
Task IDThe unique identifier for the task.
Approval StatusThe approval status to set on the task.
CompletedWhether the task is marked as complete. Select 'Do not change' to leave the existing value untouched.
Completed ByThe 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 IDThe unique identifier of the user assigned to the task.
Assignee Section IDThe 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 StatusThe 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 IDThe unique identifier for the workspace. Required when the account has multiple workspaces.
Start AtThe 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 OnThe date work for this project begins, or null if no start date is set. Format: YYYY-MM-DD.
Resource SubtypeThe subtype of the resource (e.g., 'default_task', 'milestone'). See Asana resource subtypes for valid values.
Parent IDThe unique identifier of the parent element.
HTML NotesThe rich-text notes for the resource as HTML. See Rich text in the Asana API for supported markup.
NotesFree-form plain-text description associated with the resource. For rich formatting use HTML Notes instead.
NameThe display name of the resource. A short sentence fragment that fits on a single line in the UI for maximum readability.
Is LikedWhether the task is marked as 'liked' for the authenticated user. Select 'Do not change' to leave the existing value untouched.
Due AtThe date and time the task is due. Format: ISO 8601 in UTC. Should not be used together with Due On.
Due OnThe date the project or task is due. Format: YYYY-MM-DD. Should not be used together with Due At.