Skip to main content

Asana Component

Manage users, projects, and teams in your Asana workspace

Component key: asana

Description#

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 your Asana workspace.

A Note on Asana Pagination#

Asana's API is paginated. That means that their API will return up to 100 results for any query. If additional results are available, an Asana step will return an additional property, next_page alongside the data that is returned.

{  "data": {},  "next_page": {    "offset": "yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9",    "path": "/tasks?project=1337&limit=5&offset=yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9",    "uri": "https://app.asana.com/api/1.0/tasks?project=1337&limit=5&offset=yJ0eXAiOiJKV1QiLCJhbGciOiJIRzI1NiJ9"  }}

The offset returned from next_page can be used in a subsequent query to fetch additional results.

See Asana's docs for information about Asana's paginated API, and this quickstart for information on looping over a paginated API in Prismatic.

Asana Connections#

Asana Personal Access Token#

Developer personal access tokens can be used for development purposes, but you should use an OAuth 2.0 connection when you deploy your integration (so your users can log in with their accounts).

To generate an personal access token, log in to Asana and open app.asana.com/0/my-apps. Then, click + Create new token.

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

InputNotesExample
Input
Personal Access Token
string
/ Required
apiKey
Notes
Log in to https://app.asana.com/0/my-apps to fetch a personal access token for development purposes
Example
1/example

Asana OAuth 2.0 Connection#

To make API requests of Asana on behalf of your customers you need to create an "OAuth app" within Asana. Log in to Asana and then visit app.asana.com/0/my-apps.

  • Click Create new app
  • Give your app a name and agree to Asana's terms and conditions
  • Open OAuth from the left-hand menu and take note of the generated Client ID and Client secret
  • Click + Add redirect URL and enter https://oauth2.prismatic.io/callback

Finally, when creating your Asana integration update your Asana connection with the Client ID and Client secret that you noted.

InputDefaultNotes
Input
Authorize URL
string
/ Required
Hidden Field
authorizeUrl
Default
https://app.asana.com/-/oauth_authorize
Notes
The OAuth 2.0 Authorization URL for Asana
Input
Client ID
string
/ Required
clientId
Default
Notes
Generate from https://app.asana.com/0/my-apps/
Input
Client secret
password
/ Required
clientSecret
Default
Notes
Generate from https://app.asana.com/0/my-apps/
Input
Scopes
string
Hidden Field
scopes
Default
Notes
Asana does not support granular scopes.
Input
Token URL
string
/ Required
Hidden Field
tokenUrl
Default
https://app.asana.com/-/oauth_token
Notes
The OAuth 2.0 Token URL for Asana

Triggers#

Asana Webhook#

Handle and validate webhook requests from Asana | key: webhook


Data Sources#

Select Projects#

Select one or more Projects | key: selectProject | type: picklist

InputNotes
Input
Connection
connection
/ Required
connection
Notes
 
Input
Team
string
team
Notes
 
Input
Workspace
string
workspace
Notes
 

Select Workspace#

Select one or many Workspaces | key: selectWorkspace | type: picklist

InputNotes
Input
Connection
connection
/ Required
connection
Notes
 

Actions#

Add Custom Field To Portfolio#

Add a custom field to an existing portfolio | key: addCustomFieldToPortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Field ID
string
/ Required
fieldId
Default
Notes
The unique identifier of the field
Example
843750385
Input
Insert After
string
insertAfter
Default
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
insertBefore
Default
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Is Important
boolean
/ Required
isImportant
Default
true
Notes
Determines if the custom field will be marked as important
Example
 
Input
Portfolio ID
string
/ Required
portfolioId
Default
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Add Custom Field To Project#

Add a new Custom Field to an existing Project | key: addCustomFieldToProject

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Field ID
string
/ Required
fieldId
Default
Notes
The unique identifier of the field
Example
843750385
Input
Insert After
string
insertAfter
Default
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
insertBefore
Default
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Is Important
boolean
/ Required
isImportant
Default
true
Notes
Determines if the custom field will be marked as important
Example
 
Input
Project ID
string
/ Required
projectId
Default
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202476446247138",      "resource_type": "custom_field_setting",      "custom_field": {        "gid": "1202476274909067",        "resource_type": "custom_field",        "created_by": {          "gid": "1202467472237333",          "resource_type": "user",          "name": "Example User"        },        "resource_subtype": "multi_enum",        "type": "multi_enum",        "name": "Do you want these things?",        "enum_options": [          {            "gid": "1202476274909068",            "resource_type": "enum_option",            "enabled": true,            "name": "My First Option",            "color": "green"          },          {            "gid": "1202476274909069",            "resource_type": "enum_option",            "enabled": true,            "name": "My Second Option",            "color": "red"          },          {            "gid": "1202476274909070",            "resource_type": "enum_option",            "enabled": true,            "name": "My Third Option",            "color": "orange"          }        ]      },      "is_important": true,      "parent": {        "gid": "1202467472002605",        "resource_type": "project",        "name": "Brand redesign campaign"      },      "project": {        "gid": "1202467472002605",        "resource_type": "project",        "name": "Brand redesign campaign"      }    }  }}

Add Followers To Task#

Add followers to an existing task | key: addFollowersToTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Followers List
string
Value List
followersList
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461451752271",      "resource_type": "task",      "created_at": "2022-06-16T21:17:30.519Z",      "name": "My task name",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ]    }  }}

Add Tag To Task#

Add a tag to an existing task | key: addTagToTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Tag ID
string
/ Required
tagId
Notes
The unique identifier of the tag
Example
843750385
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Add Task To Section#

Add an existing task to the given section of a project | key: addTaskToSection

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Insert After
string
insertAfter
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
insertBefore
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Section ID
string
/ Required
sectionId
Notes
The unique identifier of the section
Example
843750385
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Add User To Team#

Add an existing user to the given team | key: addUserToTeam

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Team ID
string
/ Required
teamId
Notes
Provide the unique identifier of the team.
Example
843750385
Input
User ID
string
/ Required
userId
Notes
The global ID of a user
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270530",      "resource_type": "team_membership",      "team": {        "gid": "1202178854270529",        "resource_type": "team",        "name": "Engineering"      },      "user": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "is_guest": false    }  }}

Add User To Workspace#

Add a new user to the given workspace | key: addUser

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
User ID
string
/ Required
userId
Notes
The global ID of a user
Example
375893453
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "resource_type": "user",      "name": "Example User",      "email": "user@example.com",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      }    }  }}

Add Users To Portfolio#

Add existing users to the given portfolio | key: addUserToPortfolio

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Members
string
Value List
members
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202474374782519",      "resource_type": "portfolio",      "created_at": "2022-06-20T16:48:04.621Z",      "created_by": {        "gid": "1202467472237333",        "resource_type": "user",        "name": "Example User"      },      "owner": {        "gid": "1202467472237333",        "resource_type": "user",        "name": "Example User"      },      "name": "My Portfolio",      "public": true,      "members": [        {          "gid": "1202467472237333",          "resource_type": "user",          "name": "Example User"        },        {          "gid": "1202467584678838",          "resource_type": "user",          "name": "Developer Name"        }      ],      "custom_field_settings": [],      "workspace": {        "gid": "1202467471973207",        "resource_type": "workspace",        "name": "Example Workspace"      },      "permalink_url": "https://app.asana.com/0/portfolio/1202474374782519",      "color": "none",      "due_on": null,      "start_on": null,      "current_status_update": {        "gid": "1202475750145512",        "resource_type": "status_update",        "title": "This Portfolio of work is on track!"      }    }  }}

Add Users To Project#

Add an existing user to the given project | key: addUserToProject

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Members
string
Value List
members
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461834400501",      "resource_type": "project",      "created_at": "2022-06-16T22:59:28.974Z",      "modified_at": "2022-06-16T22:59:31.222Z",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "due_on": null,      "current_status": null,      "public": true,      "name": "My new project name",      "notes": "My new project notes",      "html_notes": "<body>My new project notes</body>",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "start_on": null,      "color": "light-green",      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ]    }  }}

Attach File to Task#

Attach a file to a task | key: attachFileToTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
File
data
/ Required
file
Notes
File to attach. This should be a reference to a previous step
Example
 
Input
File Name
string
/ Required
fileName
Notes
Name of the file to attach
Example
my-image.png
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "attachment",      "name": "Screenshot.png",      "resource_subtype": "asana"    }  }}

Create Portfolio#

Create a new portfolio | key: createPortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
color
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Public
boolean
/ Required
isPublic
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Members
string
Value List
members
Default
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio Name
string
/ Required
portfolioName
Default
Notes
Give a name to the portfolio
Example
My Portfolio
Input
Workspace ID
string
/ Required
workspaceId
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Create Project#

Create a new project inside of an existing team or organization | key: createProjects

InputDefaultNotesExample
Input
Archived
boolean
archived
Default
false
Notes
True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
Example
 
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Default View
string
/ Required
defaultView
Default
list
Notes
The default view of the project.
Example
 
Input
Due On
string
dueOn
Default
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers
string
followers
Default
Notes
Provide a comma separated string of users.
Example
8570756435,375893453
Input
Public
boolean
/ Required
isPublic
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Name
string
name
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Owner ID
string
/ Required
owner
Default
Notes
Provide the unique identifier of the owner of the project.
Example
375893453
Input
Project Color
string
projectColor
Default
light-green
Notes
The default color for your project
Example
 
Input
Start On
string
startOn
Default
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Team ID
string
/ Required
team
Default
Notes
The team that this project is shared with. This field only exists for projects in organizations. Including this field if you do not meet those conditions could cause your request to fail.
Example
375893453
Input
Workspace ID
string
workspaceId
Default
Notes
Include this value if you would like this project to be included in a workspace.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461772995112",      "resource_type": "project",      "created_at": "2022-06-16T22:53:48.986Z",      "modified_at": "2022-06-16T22:53:48.986Z",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "due_on": null,      "current_status": null,      "public": false,      "name": "My Cool Project",      "notes": "Some notes on my project",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "start_on": null,      "color": "light-green",      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>Some notes on my project</body>"    }  }}

Create Section#

Create a new section of a project | key: createSection

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Connection
connection
/ Required
connectionInput
Notes
 
Example
 
Input
Insert After
string
insertAfter
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
insertBefore
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Section Name
string
/ Required
sectionName
Notes
Provide a value for the name of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202465892953048",      "resource_type": "section",      "created_at": "2022-06-17T15:53:48.455Z",      "name": "My Example Section",      "project": {        "gid": "1202178854270532",        "resource_type": "project"      }    }  }}

Create Status Update#

Create a status update from a project, portfolio, or goal | key: createStatusUpdate

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Limit
string
limit
Default
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Default
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project, portfolio, or goal ID
string
/ Required
parent
Default
Notes
The GID for a project, portfolio, or goal
Example
375893453
Input
This represents the current state of the object
string
/ Required
statusType
Default
on_track
Notes
 
Example
 
Input
Status Text
string
/ Required
statusUpdateText
Default
Notes
The text content of the status update.
Example
The project is moving forward according to plan.
Input
Status Title
string
/ Required
statusUpdateTitle
Default
Notes
The title of the project status update.
Example
Example Status Update - Jun 15

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466825616154",      "resource_type": "status_update",      "num_hearts": 0,      "num_likes": 0,      "title": "Example project is going well",      "created_at": "2022-06-17T19:09:58.169Z",      "modified_at": "2022-06-17T19:09:58.169Z",      "status_type": "on_track",      "text": "It'll be completed on time!",      "parent": {        "gid": "1202178854270532",        "resource_type": "project",        "name": "Example Project"      },      "resource_subtype": "project_status_update",      "hearted": false,      "hearts": [],      "liked": false,      "likes": [],      "created_by": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "html_text": "<body>It'll be completed on time!</body>"    }  }}

Create Tag#

Create a new tag | key: createTag

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
color
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Followers List
string
Value List
followersList
Default
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Name
string
name
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Workspace ID
string
/ Required
workspaceId
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202453507919841",      "resource_type": "tag",      "create_at": "2022-06-15T17:03:26.911Z",      "name": "My Example Tag",      "workspace": {        "gid": 1126509132283071,        "resource_type": "workspace"      },      "color": "light-green",      "followers": []    }  }}

Create Task#

Create a new task inside a workspace or organization | key: createTask

InputNotesExample
Input
Approval Status
string
/ Required
approvalStatus
Notes
Provide a string value for the approval status of the task.
Example
Pending
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Assignee ID
string
assigneeId
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Assignee Section ID
string
assigneeSectionId
Notes
Provide the unique identifier of 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.
Example
843750385
Input
Assignee Status
string
assigneeStatus
Notes
Provide a string value representing the status the task has in relation to its assignee. This field is deprecated, you can still use it to form requests but it is not recommended for creating new records.
Example
upcoming
Input
Completed By
string
completedBy
Notes
Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.
Example
John Doe
Input
Due At
string
dueAt
Notes
Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.
Example
2019-09-15T02:06:58.147Z
Input
Due On
string
dueOn
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers List
string
Value List
followersList
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Completed
string
isCompleted
Notes
True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Example
 
Input
Is Liked
string
isLiked
Notes
This flag will mark the specified task as 'liked' in your Asana account.
Example
 
Input
Name
string
name
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Parent ID
string
parentId
Notes
Provide the unique identifier of the parent element.
Example
843750385
Input
Project List
string
Value List
projectList
Notes
For each item, provide the unique identifier of the project.
Example
843750385
Input
Resource Subtype
string
resourceSubtype
Notes
Provide a string value for the type of object.
Example
task
Input
Start On
string
startOn
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461248558215",      "projects": [],      "memberships": [],      "resource_type": "task",      "created_at": "2022-06-16T20:30:21.641Z",      "modified_at": "2022-06-16T20:30:21.932Z",      "name": "My Task Name",      "is_rendered_as_separator": false,      "notes": "Here's my task notes!",      "assignee": {        "gid": "1202178852626547",        "resource_type": "user"      },      "completed": false,      "assignee_status": "inbox",      "completed_at": null,      "due_on": null,      "due_at": null,      "resource_subtype": "default_task",      "start_on": null,      "tags": [],      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "liked": false,      "num_likes": 0,      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>Here's my task notes!</body>",      "parent": null,      "likes": []    }  }}

Create Team#

Create a new team | key: createTeam

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Organization or Workspace ID
string
/ Required
organizationId
Notes
Provide the unique identifier of the organization or workspace
Example
375893453
Input
Description
string
teamDescription
Notes
Provide a string value for the description of the team.
Example
This is an example description
Input
Name
string
/ Required
teamName
Notes
Provide a string value for the name of the team.
Example
Engineering Team

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466032099844",      "resource_type": "team",      "name": "My New Team",      "permalink_url": "https://app.asana.com/0/1202466032099844",      "organization": {        "gid": "1126509132283071",        "resource_type": "workspace",        "name": "Prismatic"      }    }  }}

Create Webhook#

Create a webhook to send data from Asana to an instance URL | key: createWebhook

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Webhook URL
string
/ Required
endpoint
Notes
Reference a flow's URL from the trigger payload
Example
 
Input
Resource ID
string
/ Required
resourceId
Notes
The GID of a project, portfolio, goal, task, etc - the resource to listen for
Example
375893453

Delete Attachment#

Delete an existing attachment | key: deleteAttachment

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Attachment ID
string
/ Required
attachmentId
Notes
Provide an id for the given attachment
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Instance Webhooks#

Delete all Asana webhooks that point to a flow in this instance | key: deleteInstanceWebhooks

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Delete Portfolio#

Delete the information and metadata of a portfolio | key: deletePortfolio

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Project#

Delete the information and metadata of a project by Id | key: deleteProjects

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Section#

Delete the information and metadata of a section | key: deleteSection

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Section ID
string
/ Required
sectionId
Notes
The unique identifier of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Status#

Delete a status update | key: deleteStatus

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Status ID
string
/ Required
statusId
Notes
The gid of the status update
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Tag#

Delete the information and metadata of the given tag | key: deleteTag

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Tag ID
string
/ Required
tagId
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Task#

Delete the information and metadata of an existing task | key: deleteTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Delete Webhook#

Delete a webhook by ID | key: deleteWebhook

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Webhook ID
string
/ Required
webhookId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {}}

Find Tag by Name#

Find a tag of a given name within a workspace | key: findTagByName

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Tag Name
string
/ Required
tagName
Notes
Note: if multiple tags share a name, only one tag will be returned.
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1202467057873527",    "color": "dark-green",    "created_at": "2022-06-17T20:28:26.601Z",    "name": "My Example Tag Name",    "resource_type": "tag"  }}

Find Team by Name#

Find a team of a given name within a workspace | key: findTeamByName

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Team Name
string
/ Required
teamName
Notes
Note: if multiple teams share a name, only one team will be returned.
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1126509132283071",    "name": "Example Team",    "resource_type": "team"  }}

Find User by Name or Email#

Find a user with the given name or email address in your workspace | key: findUserByNameOrEmail

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
User's Email
string
userEmail
Notes
Note: if multiple users share an email address, only one user will be returned.
Example
john.doe@example.com
Input
User's Full Name
string
userName
Notes
Note: if multiple users share a name, only one user will be returned.
Example
John Doe
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "gid": "1126508793140155",    "email": "user@example.com",    "name": "Example User",    "resource_type": "user",    "workspaces": [      {        "gid": "1126509132283071",        "name": "Example Workspace",        "resource_type": "workspace"      }    ]  }}

Find Workspace by Name#

Find a workspace of a given name | key: findWorkspaceByName

InputNotes
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Input
Workspace Name
string
/ Required
workspaceName
Notes
 

Output Example Payload#

{  "data": {    "gid": "1126509132283071",    "name": "Example Workspace",    "resource_type": "workspace"  }}

Get Attachments#

Get the information and metadata of an attachment | key: getAttachment

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Attachment ID
string
/ Required
attachmentId
Notes
Provide an id for the given attachment
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "attachment",      "name": "Screenshot.png",      "resource_subtype": "dropbox",      "created_at": "2012-02-22T02:06:58.147Z",      "download_url": "https://s3.amazonaws.com/assets/123/Screenshot.png",      "host": "dropbox",      "parent": {        "gid": "12345",        "resource_type": "task",        "name": "Bug Task",        "resource_subtype": "default_task"      },      "permanent_url": "https://s3.amazonaws.com/assets/123/Screenshot.png",      "view_url": "https://www.dropbox.com/s/123/Screenshot.png"    }  }}

Get Current User#

Get information about the currently authenticated user | key: getCurrentUser

InputNotes
Input
Connection
connection
/ Required
asanaConnection
Notes
 

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "email": "user@example.com",      "name": "Example User",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      },      "resource_type": "user",      "workspaces": [        {          "gid": "1126509132283071",          "name": "Example Workspace",          "resource_type": "workspace"        }      ]    }  }}

Get Custom Field#

Get the information and metadata of a custom field | key: getCustomField

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Field ID
string
/ Required
fieldId
Notes
The unique identifier of the field
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202467472002610",      "enum_options": [        {          "gid": "1202467472002611",          "color": "red",          "enabled": true,          "name": "High",          "resource_type": "enum_option"        },        {          "gid": "1202467472002612",          "color": "orange",          "enabled": true,          "name": "Medium",          "resource_type": "enum_option"        },        {          "gid": "1202467472002613",          "color": "yellow-orange",          "enabled": true,          "name": "Low",          "resource_type": "enum_option"        }      ],      "name": "Priority",      "description": "Asana-created. Track the priority of each task.",      "resource_subtype": "enum",      "resource_type": "custom_field"    }  }}

Get Portfolio#

Get the information and metadata of a portfolio | key: getPortfolio

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Get Project#

Get the information and metadata of a project by Id | key: getProject

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461773653662",      "archived": false,      "color": "light-green",      "created_at": "2022-06-16T22:55:11.208Z",      "current_status": null,      "custom_fields": [],      "due_on": null,      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "html_notes": "<body>My new project notes</body>",      "members": [        {          "gid": "1202178852626547",          "resource_type": "user"        }      ],      "modified_at": "2022-06-16T22:55:13.275Z",      "name": "My new project name",      "notes": "My new project notes",      "owner": {        "gid": "1202178852626547",        "resource_type": "user"      },      "public": true,      "resource_type": "project",      "start_on": null,      "team": {        "gid": "1202178854270529",        "resource_type": "team"      },      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      }    }  }}

Get Section#

Get the information and metadata of a section | key: getSection

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Section ID
string
/ Required
sectionId
Notes
The unique identifier of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270533",      "created_at": "2022-04-25T19:28:56.749Z",      "name": "Discussion topics",      "project": {        "gid": "1202178854270532",        "name": "My Example Project",        "resource_type": "project"      },      "resource_type": "section"    }  }}

Get Status Update#

Get a status update | key: getStatusUpdate

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Status ID
string
/ Required
statusId
Notes
The gid of the status update
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202466832682204",      "created_at": "2022-06-17T19:14:25.512Z",      "created_by": {        "gid": "1202178852626547",        "name": "Example User",        "resource_type": "user"      },      "modified_at": "2022-06-17T19:14:26.506Z",      "resource_type": "status_update",      "resource_subtype": "project_status_update",      "status_type": "on_track",      "text": "It'll be completed on time!",      "title": "Example project is going well",      "parent": {        "gid": "1202178854270532",        "name": "Example Project",        "resource_type": "project"      }    }  }}

Get Status Updates from Object#

Get status updates from a project, portfolio, or goal | key: getStatusesForObject

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project, portfolio, or goal ID
string
/ Required
parent
Notes
The GID for a project, portfolio, or goal
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202466843571433",        "created_at": "2022-06-17T19:22:53.380Z",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "status_type": "at_risk",        "text": "We accidentally force-pushed over our repo!",        "title": "It's going terribly!",        "parent": {          "gid": "1202178854270532",          "resource_type": "project"        }      },      {        "gid": "1202466947841625",        "created_at": "2022-06-17T19:17:33.744Z",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "status_type": "on_track",        "text": "It'll be completed on time!",        "title": "Example project is going well",        "parent": {          "gid": "1202178854270532",          "resource_type": "project"        }      }    ]  }}

Get Tag#

Get the information and metadata of the given tag | key: getTag

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Tag ID
string
/ Required
tagId
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461566347259",      "color": "light-green",      "created_at": "2022-06-16T21:44:38.673Z",      "followers": [],      "name": "My Example Tag",      "notes": "My Notes",      "resource_type": "tag",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      }    }  }}

Get Task#

Get the information and metadata of a task | key: getTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "75834703724",      "projects": "",      "resource_type": "task",      "name": "MyTask",      "notes": "These are my example task notes!",      "completed": false,      "resource_subtype": "default_task",      "tags": "",      "workspace": {        "gid": "867452364563",        "resource_type": "workspace",        "name": "Example Workspace"      },      "custom_fields": {},      "assignee": {        "gid": "32493284234",        "name": "Example Assignee",        "resource_type": "user"      },      "parent": null,      "assignee_status": "inbox",      "hearted": false    }  }}

Get Team#

Get the information and metadata of a team | key: getTeam

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Team ID
string
/ Required
teamId
Notes
Provide the unique identifier of the team.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1126509132283073",      "name": "Example Team",      "organization": {        "gid": "1126509132283071",        "name": "Example Org",        "resource_type": "workspace"      },      "permalink_url": "https://app.asana.com/0/1126509132283073",      "resource_type": "team"    }  }}

Get User#

Get the information and metadata of a user | key: getUsers

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
User ID
string
/ Required
userId
Notes
The global ID of a user
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126508793140155",      "email": "user@example.com",      "name": "Example User",      "photo": {        "image_21x21": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_21x21.png",        "image_27x27": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_27x27.png",        "image_36x36": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_36x36.png",        "image_60x60": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_60x60.png",        "image_128x128": "https://s3.amazonaws.com/profile_photos/1126508793140155.1126509132283075.joZwntHYCrotR7QnI82A_128x128.png"      },      "resource_type": "user",      "workspaces": [        {          "gid": "1126509132283071",          "name": "Example Workspace",          "resource_type": "workspace"        }      ]    }  }}

Get Workspace#

Get the information and metadata of the given Workspace | key: getWorkspace

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1126509132283071",      "email_domains": [        "example.com"      ],      "is_organization": true,      "name": "Example Workspace",      "resource_type": "workspace"    }  }}

List Custom Fields#

List all custom fields in a workspace | key: listCustomFields

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202467472002610",        "enum_options": [          {            "gid": "1202467472002611",            "color": "red",            "enabled": true,            "name": "High",            "resource_type": "enum_option"          },          {            "gid": "1202467472002612",            "color": "orange",            "enabled": true,            "name": "Medium",            "resource_type": "enum_option"          },          {            "gid": "1202467472002613",            "color": "yellow-orange",            "enabled": true,            "name": "Low",            "resource_type": "enum_option"          }        ],        "name": "Priority",        "description": "Asana-created. Track the priority of each task.",        "resource_subtype": "enum",        "resource_type": "custom_field"      },      {        "gid": "1202476274909067",        "enum_options": [          {            "gid": "1202476274909068",            "color": "green",            "enabled": true,            "name": "My First Option",            "resource_type": "enum_option"          },          {            "gid": "1202476274909069",            "color": "red",            "enabled": true,            "name": "My Second Option",            "resource_type": "enum_option"          },          {            "gid": "1202476274909070",            "color": "orange",            "enabled": true,            "name": "My Third Option",            "resource_type": "enum_option"          }        ],        "name": "Do you want these things?",        "description": "",        "resource_subtype": "multi_enum",        "resource_type": "custom_field"      },      {        "gid": "1202476390317834",        "name": "Milestone",        "description": "",        "resource_subtype": "text",        "resource_type": "custom_field"      },      {        "gid": "1202476390885516",        "name": "Percent Complete",        "description": "",        "precision": 0,        "resource_subtype": "number",        "resource_type": "custom_field"      }    ]  }}

List Portfolio Items#

List all items in a given portfolio | key: listPortfolioItems

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "project",        "name": "Stuff to buy"      }    ]  }}

List Portfolios#

List portfolios that the authenticated user owns | key: listPortfolios

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "portfolio",        "name": "Example Portfolio"      }    ]  }}

List Projects#

Return a list of all projects connected to your account | key: listProjects

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270532",        "archived": false,        "color": "light-pink",        "created_at": "2022-04-25T19:28:55.557Z",        "current_status": null,        "custom_fields": [],        "due_on": "2022-05-25",        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>Asana helps you plan your 1:1s in advance, stay focused during the conversation, and track notes and action items.</body>",        "members": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "modified_at": "2022-06-15T21:21:40.641Z",        "name": "[Sample] [Teammate] / Prismatic 1:1",        "notes": "Asana helps you plan your 1:1s in advance, stay focused during the conversation, and track notes and action items.",        "owner": {          "gid": "1202178852626547",          "resource_type": "user"        },        "public": false,        "resource_type": "project",        "start_on": "2022-04-25",        "team": {          "gid": "1202178854270529",          "resource_type": "team"        },        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Sections#

List all sections of the given project | key: listSections

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270533",        "created_at": "2022-04-25T19:28:56.749Z",        "name": "Discussion topics",        "project": {          "gid": "1202178854270532",          "resource_type": "project"        },        "resource_type": "section"      },      {        "gid": "1202178854270541",        "created_at": "2022-04-25T19:28:59.950Z",        "name": "FYIs",        "project": {          "gid": "1202178854270532",          "resource_type": "project"        },        "resource_type": "section"      }    ]  }}

List Subtasks#

Return a list of all subtasks in a given task | key: listSubtasks

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202461528125029",        "assignee": {          "gid": "1202178852626547",          "resource_type": "user"        },        "assignee_status": "inbox",        "completed": false,        "completed_at": null,        "created_at": "2022-06-16T21:31:46.425Z",        "due_at": null,        "due_on": null,        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>Here's my task notes!</body>",        "is_rendered_as_separator": false,        "liked": false,        "likes": [],        "memberships": [],        "modified_at": "2022-06-16T21:31:54.809Z",        "name": "My new task name",        "notes": "Here's my task notes!",        "num_likes": 0,        "num_subtasks": 0,        "parent": {          "gid": "1202178854270531",          "resource_type": "task"        },        "projects": [],        "resource_type": "task",        "start_on": null,        "tags": [          {            "gid": "1202453664069905",            "resource_type": "tag"          }        ],        "resource_subtype": "default_task",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Tags#

List all tags in your account | key: listTags

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202453507919841",        "color": "light-green",        "created_at": "2022-06-15T17:03:26.911Z",        "followers": [],        "name": "My example tag",        "resource_type": "tag",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Tags In Task#

List all tags in a given task | key: listTagsInTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202453664069905",        "color": "light-green",        "created_at": "2022-06-15T17:32:21.828Z",        "followers": [],        "name": "My example tag",        "resource_type": "tag",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List task attachments#

List all attachments in a given task | key: listAttachments

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "12345",        "resource_type": "attachment",        "name": "Screenshot.png",        "resource_subtype": "dropbox"      }    ]  }}

List Tasks#

Return a list of tasks | key: listTasks

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Assignee ID
string
assigneeId
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Project ID
string
projectId
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Workspace ID
string
workspaceId
Notes
The gid of the workspace
Example
375893453

You must specify a project, or a combination of an assignee and workspace.

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1202178854270531",        "assignee": {          "gid": "1202178852626547",          "resource_type": "user"        },        "assignee_status": "today",        "completed": false,        "completed_at": null,        "created_at": "2022-04-25T19:28:54.408Z",        "due_at": null,        "due_on": "2022-05-02",        "followers": [          {            "gid": "1202178852626547",            "resource_type": "user"          }        ],        "html_notes": "<body>We’ve collected a set of guides, tips, and tutorials to help you learn about Asana. Check it out:<ul><li><a href=\"https://asana.com/guide\">https://asana.com/guide</a></li></ul></body>",        "is_rendered_as_separator": false,        "liked": false,        "likes": [],        "memberships": [          {}        ],        "modified_at": "2022-06-15T21:21:41.151Z",        "name": "Learn how Asana works",        "notes": "We’ve collected a set of guides, tips, and tutorials to help you learn about Asana. Check it out: https://asana.com/guide\n",        "num_likes": 0,        "num_subtasks": 0,        "parent": null,        "projects": [          {            "gid": "1202178854270532",            "resource_type": "project"          }        ],        "resource_type": "task",        "start_on": null,        "tags": [          {            "gid": "1202453664069905",            "resource_type": "tag"          },          {            "gid": "1202454369674628",            "resource_type": "tag"          },          {            "gid": "1202454863218026",            "resource_type": "tag"          }        ],        "resource_subtype": "default_task",        "workspace": {          "gid": "1126509132283071",          "resource_type": "workspace"        }      }    ]  }}

List Teams#

List all teams in the given workspace | key: listTeams

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126509132283073",        "name": "Founders",        "resource_type": "team"      },      {        "gid": "1201132129713512",        "name": "Design",        "resource_type": "team"      },      {        "gid": "1201340876723312",        "name": "Engineering",        "resource_type": "team"      }    ]  }}

List Users#

List all users in your account | key: listUsers

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Workspace ID
string
workspaceId
Notes
Optionally filter by workspace ID
Example
375893453

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126508793140155",        "name": "Example User 1",        "resource_type": "user",        "email": "user-1@example.com",        "workspaces": [          {            "gid": "1126509132283071",            "resource_type": "workspace"          }        ]      },      {        "gid": "1126508793140156",        "name": "Example User2 ",        "resource_type": "user",        "email": "user-2@example.com",        "workspaces": [          {            "gid": "1126509132283071",            "resource_type": "workspace"          }        ]      }    ]  }}

List Workspace Webhooks#

List all webhooks configured in Asana, including those for other integrations | key: listWebhooks

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Limit
string
limit
Default
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Default
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9
Input
Show only instance webhooks
boolean
showOnlyInstanceWebhooks
Default
true
Notes
Show only webhooks that point to this instance
Example
 
Input
Workspace ID
string
/ Required
workspaceId
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": [    {      "gid": "1202700984385446",      "active": true,      "resource": {        "gid": "1202467472002605",        "name": "Brand redesign campaign",        "resource_type": "project"      },      "resource_type": "webhook",      "target": "https://hooks.prismatic.io/trigger/EXAMPLE"    }  ]}

List Workspaces#

List of all workspaces connected to your account | key: listWorkspaces

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Limit
string
limit
Notes
The maximum number of items you would like returned (between 1 and 100)
Example
20
Input
Offset
string
offset
Notes
An offset token returned from a previous query that had a next_page property
Example
eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9

Output Example Payload#

{  "data": {    "data": [      {        "gid": "1126509132283071",        "name": "Example Workspace 1",        "resource_type": "workspace"      },      {        "gid": "1126509132283072",        "name": "Example Workspace 2",        "resource_type": "workspace"      }    ]  }}

Raw Request#

Send Raw Request to Asana | key: rawRequest

InputDefaultNotesExample
Input
Connection
connection
/ Required
connection
Default
 
Notes
 
Example
 
Input
Data
string
data
Default
Notes
The HTTP body payload to send to the URL.
Example
{"exampleKey": "Example Data"}
Input
Debug Request
boolean
debugRequest
Default
false
Notes
Enabling this flag will log out the current request.
Example
 
Input
File Data
string
Key Value List
fileData
Default
Notes
File Data to be sent as a multipart form upload.
Example
[{key: "example.txt", value: "My File Contents"}]
Input
File Data File Names
string
Key Value List
fileDataFileNames
Default
Notes
File names to apply to the file data inputs. Keys must match the file data keys above.
Example
 
Input
Form Data
string
Key Value List
formData
Default
Notes
The Form Data to be sent as a multipart form upload.
Example
[{"key": "Example Key", "value": new Buffer("Hello World")}]
Input
Header
string
Key Value List
headers
Default
Notes
A list of headers to send with the request.
Example
User-Agent: curl/7.64.1
Input
Max Retry Count
string
maxRetries
Default
0
Notes
The maximum number of retries to attempt.
Example
 
Input
Method
string
/ Required
method
Default
Notes
The HTTP method to use.
Example
 
Input
Query Parameter
string
Key Value List
queryParams
Default
Notes
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.
Example
 
Input
Response Type
string
/ Required
responseType
Default
json
Notes
The type of data you expect in the response. You can request json, text, or binary data.
Example
 
Input
Retry On All Errors
boolean
retryAllErrors
Default
false
Notes
If true, retries on all erroneous responses regardless of type.
Example
 
Input
Retry Delay (ms)
string
retryDelayMS
Default
0
Notes
The delay in milliseconds between retries.
Example
 
Input
Timeout
string
timeout
Default
Notes
The maximum time that a client will await a response to its request
Example
2000
Input
URL
string
/ Required
url
Default
Notes
This is the URL to call.
Example
/goals
Input
Use Exponential Backoff
boolean
useExponentialBackoff
Default
false
Notes
Specifies whether to use a pre-defined exponential backoff strategy for retries.
Example
 

Remove Custom Field From Portfolio#

Remove a custom field from an existing portfolio | key: removeCustomFieldFromPortfolio

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Field ID
string
/ Required
fieldId
Notes
The unique identifier of the field
Example
843750385
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Custom Field From Project#

Remove an existing Custom Field from an existing Project | key: removeCustomFieldFromProject

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Field ID
string
/ Required
fieldId
Notes
The unique identifier of the field
Example
843750385
Input
Project ID
string
/ Required
projectId
Notes
Provide the unique identifier of the project.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Followers From Task#

Remove followers from the given task | key: removeFollowersFromTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Followers List
string
Value List
followersList
Notes
For each item, provide the unique identifier of an existing userId.
Example
843750385
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461530991735",      "resource_type": "task",      "created_at": "2022-06-16T21:33:52.572Z",      "name": "My new task name",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "followers": []    }  }}

Remove Portfolio Item#

Remove an existing item from the given portfolio | key: removePortfolioItem

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Item ID
string
/ Required
itemId
Notes
Provide the unique identifier of the Item.
Example
843750385
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Tag From Task#

Remove a tag from the given task | key: removeTagFromTask

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Tag ID
string
/ Required
tagId
Notes
The unique identifier of the tag
Example
843750385
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453

Output Example Payload#

{  "data": {    "data": {}  }}

Remove Users From Portfolio#

Remove existing users from the given portfolio | key: removeUserFromPortfolio

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Members
string
Value List
members
Notes
For each value, provide the user id of a member. These can either be the string 'me', an email, or the gid of a user.
Example
843750385
Input
Portfolio ID
string
/ Required
portfolioId
Notes
Provide the unique identifier of the portfolio.
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202476367473313",      "resource_type": "portfolio",      "created_at": "2022-06-20T18:18:47.435Z",      "created_by": {        "gid": "1202467472237333",        "resource_type": "user"      },      "name": "Example Portfolio",      "members": [        {          "gid": "1202467472237333",          "resource_type": "user"        },        {          "gid": "1202467584678838",          "resource_type": "user"        }      ],      "custom_field_settings": [],      "workspace": {        "gid": "1202467471973207",        "resource_type": "workspace"      },      "color": "light-green"    }  }}

Update Portfolio#

Update the information and metadata of the given portfolio | key: updatePortfolio

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Color
string
color
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Public
boolean
/ Required
isPublic
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Portfolio ID
string
/ Required
portfolioId
Default
Notes
Provide the unique identifier of the portfolio.
Example
843750385
Input
Portfolio Name
string
portfolioName
Default
Notes
Give a name to the portfolio
Example
My Portfolio
Input
Workspace ID
string
workspaceId
Default
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "12345",      "resource_type": "portfolio",      "color": "light-green",      "name": "Bug Portfolio",      "created_at": "2012-02-22T02:06:58.147Z",      "created_by": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "current_status_update": {        "gid": "12345",        "resource_type": "status_update",        "resource_subtype": "project_status_update",        "title": "Status Update - Jun 15"      },      "custom_field_settings": [        {          "gid": "12345",          "resource_type": "custom_field_setting",          "custom_field": {            "gid": "12345",            "resource_type": "custom_field",            "created_by": {              "gid": "12345",              "resource_type": "user",              "name": "Greg Sanchez"            },            "currency_code": "EUR",            "custom_label": "gold pieces",            "custom_label_position": "suffix",            "description": "Development team priority",            "display_value": "blue",            "enabled": true,            "enum_options": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "enum_value": {              "gid": "12345",              "resource_type": "enum_option",              "color": "blue",              "enabled": true,              "name": "Low"            },            "format": "custom",            "has_notifications_enabled": true,            "is_global_to_workspace": true,            "multi_enum_values": [              {                "gid": "12345",                "resource_type": "enum_option",                "color": "blue",                "enabled": true,                "name": "Low"              }            ],            "name": "Status",            "number_value": 5.2,            "precision": 2,            "resource_subtype": "text",            "text_value": "Some Value",            "type": "text"          },          "is_important": false,          "parent": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          },          "project": {            "gid": "12345",            "resource_type": "project",            "name": "Stuff to buy"          }        }      ],      "due_on": "2019-09-15",      "members": [        {          "gid": "12345",          "resource_type": "user",          "name": "Greg Sanchez"        }      ],      "owner": {        "gid": "12345",        "resource_type": "user",        "name": "Greg Sanchez"      },      "permalink_url": "https://app.asana.com/0/resource/123456789/list",      "public": false,      "start_on": "2019-09-14",      "workspace": {        "gid": "12345",        "resource_type": "workspace",        "name": "My Company Workspace"      }    }  }}

Update Project#

Update the information and metadata of a project | key: updateProject

InputDefaultNotesExample
Input
Archived
boolean
archived
Default
false
Notes
True if the project is archived, false if not. Archived projects do not show in the UI by default and may be treated differently for queries.
Example
 
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Default View
string
defaultView
Default
Notes
The default view of the project.
Example
 
Input
Due On
string
dueOn
Default
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Followers
string
followers
Default
Notes
Provide a comma separated string of users.
Example
8570756435,375893453
Input
Public
boolean
/ Required
isPublic
Default
false
Notes
True if the object is public to its team.
Example
 
Input
Name
string
name
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Owner ID
string
owner
Default
Notes
Provide the unique identifier of the owner of the project.
Example
375893453
Input
Project Color
string
projectColor
Default
light-green
Notes
The default color for your project
Example
 
Input
Project ID
string
/ Required
projectId
Default
Notes
Provide the unique identifier of the project.
Example
375893453
Input
Start On
string
startOn
Default
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Team ID
string
team
Default
Notes
The team that this project is shared with. This field only exists for projects in organizations. Including this field if you do not meet those conditions could cause your request to fail.
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461680419124",      "resource_type": "project",      "created_at": "2022-06-16T22:39:52.270Z",      "modified_at": "2022-06-16T22:39:54.373Z",      "due_date": null,      "due_on": null,      "current_status_update": null,      "current_status": null,      "public": true,      "name": "My new project name",      "notes": "My new project notes\n",      "archived": false,      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace",        "name": "Prismatic"      },      "team": {        "gid": "1202178854270529",        "resource_type": "team",        "name": "Engineering"      },      "permalink_url": "https://app.asana.com/0/1202461680419124/1202461680419124",      "is_template": false,      "default_view": "board",      "start_on": null,      "color": "light-green",      "icon": "board",      "completed": false,      "completed_at": null,      "completed_by": null,      "owner": {        "gid": "1202178852626547",        "resource_type": "user",        "name": "Example User"      },      "members": [        {          "gid": "1202178852626547",          "resource_type": "user",          "name": "Example User"        }      ],      "followers": [        {          "gid": "1202178852626547",          "resource_type": "user",          "name": "Example User"        }      ]    }  }}

Update Section#

Update the information and metadata of a project section | key: updateSection

InputNotesExample
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Insert After
string
insertAfter
Notes
The ID of the field or section to insert this one insert after
Example
843750385
Input
Insert before
string
insertBefore
Notes
The ID of the field or section to insert this one before
Example
843750385
Input
Section ID
string
/ Required
sectionId
Notes
The unique identifier of the section
Example
843750385
Input
Section Name
string
/ Required
sectionName
Notes
Provide a value for the name of the section
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202178854270533",      "resource_type": "section",      "created_at": "2022-04-25T19:28:56.749Z",      "name": "My New Section Name",      "project": {        "gid": "1202178854270532",        "resource_type": "project"      }    }  }}

Update Tag#

Update the information and metadata of the given tag | key: updateTag

InputDefaultNotesExample
Input
Connection
connection
/ Required
asanaConnection
Default
 
Notes
 
Example
 
Input
Color
string
/ Required
color
Default
light-green
Notes
Provide a value for the color of the object.
Example
 
Input
Name
string
name
Default
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Default
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Tag ID
string
/ Required
tagId
Default
Notes
The unique identifier of the tag
Example
843750385

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461644189657",      "resource_type": "tag",      "created_at": "2022-06-16T22:04:33.095Z",      "name": "My Updated Tag Name",      "notes": "My Updated Notes",      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "color": "dark-green",      "followers": []    }  }}

Update Task#

Update the information and metadata of the given task | key: updateTask

InputNotesExample
Input
Approval Status
string
approvalStatus
Notes
Provide a string value for the approval status of the task.
Example
Pending
Input
Connection
connection
/ Required
asanaConnection
Notes
 
Example
 
Input
Assignee ID
string
assigneeId
Notes
Provide the unique identifier of the assignee.
Example
843750385
Input
Assignee Section ID
string
assigneeSectionId
Notes
Provide the unique identifier of 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.
Example
843750385
Input
Assignee Status
string
assigneeStatus
Notes
Provide a string value representing the status the task has in relation to its assignee. This field is deprecated, you can still use it to form requests but it is not recommended for creating new records.
Example
upcoming
Input
Completed By
string
completedBy
Notes
Provide a string value for the name of the user who completed the task. You can also provide a userId, or email.
Example
John Doe
Input
Due At
string
dueAt
Notes
Provide an ISO 8601 date string in UTC and should NOT be used together with Due On.
Example
2019-09-15T02:06:58.147Z
Input
Due On
string
dueOn
Notes
The date in which the project is due. This field takes a date with YYYY-MM-DD format and should not be used together with due_at.
Example
2019-09-15
Input
Completed
string
isCompleted
Notes
True if the task is completed, false if not. Select 'Do not change' to avoid updating this value.
Example
 
Input
Is Liked
string
isLiked
Notes
This flag will mark the specified task as 'liked' in your Asana account.
Example
 
Input
Name
string
name
Notes
Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.
Example
Example - Populate customers page with live data
Input
Notes
text
notes
Notes
Free-form textual information associated with the object (ie., its description).
Example
These are some example notes.
Input
Parent ID
string
parentId
Notes
Provide the unique identifier of the parent element.
Example
843750385
Input
Resource Subtype
string
resourceSubtype
Notes
Provide a string value for the type of object.
Example
task
Input
Start On
string
startOn
Notes
The day on which work for this project begins, or null if the project has no start date. This takes a date with YYYY-MM-DD format
Example
2021-11-14
Input
Task ID
string
/ Required
taskId
Notes
Provide the unique identifier for the task.
Example
375893453
Input
Workspace ID
string
workspaceId
Notes
The gid of the workspace
Example
375893453

Output Example Payload#

{  "data": {    "data": {      "gid": "1202461395122529",      "projects": [],      "memberships": [],      "resource_type": "task",      "created_at": "2022-06-16T21:15:12.578Z",      "modified_at": "2022-06-16T21:15:14.361Z",      "name": "My new task name",      "is_rendered_as_separator": false,      "notes": "Here's my task notes!",      "assignee": {        "gid": "1202178852626547",        "resource_type": "user"      },      "completed": false,      "assignee_status": "inbox",      "completed_at": null,      "due_on": null,      "due_at": null,      "resource_subtype": "default_task",      "start_on": null,      "tags": [],      "workspace": {        "gid": "1126509132283071",        "resource_type": "workspace"      },      "num_likes": 0,      "html_notes": "<body>Here's my task notes!</body>",      "parent": null,      "liked": false,      "likes": [],      "followers": []    }  }}