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

Authorization Notes#

The Asana component supports API Key and OAuth 2.0.

API Key#

Before you create the credential, you must first generate a Personal Access Token from the Asana developer console. See the Authentication Quick Start for detailed instructions on getting started with PATs.

For more information refer to the Asana Docs

Create a new credential of type API Key.

  • For API Key use the value you received from the Asana developer console.

OAuth 2.0#

Before you can create the credential, you must first register your application with Asana to receive a client ID and client secret. You can do so by visiting the Account Settings, then click the Apps tab, and "Add New Application". Remember to configure your app to use the Prismatic Redirect URL.

For more information refer to the Asana Docs

Create a new credential of type OAuth 2.0 - Authorization Code.

  • For Client ID and Client Secret enter the values that you got from the Asana developer console.
  • For Scopes enter 'default'
  • For Authorization URL enter https://app.asana.com/-/oauth_authorize
  • For Access Token URL enter https://https://app.asana.com/-/oauth_token

Actions#

Add User To Team#

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

InputKeyNotesExample

Team Id

string
/ Required
teamIdProvide the unique identifier of the team.843750385

User Id

string
/ Required
userIdProvide a unique identifier for the user375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Add User To Workspace#

Add a new user to an existing workspace | key: addUser

InputKeyNotesExample

User Id

string
/ Required
userIdProvide a unique identifier for the user375893453

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Create Project In Team#

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

InputKeyNotesExample

Archived

boolean
archivedTrue 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.

Author

string
authorProvide a string value for the name of the author. You can also provide the unique identifier of a user who belongs to the same organization/workspace.John Doe

Created By

string
createdByThis name represents an account in Asana that created the object. You can also provide a user Id or email.John Doe

Default View

string
defaultViewThe default view of the project.

Due On

string
dueOnThe 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.2019-09-15

Followers

string
followersProvide a comma separated string of users.8570756435,375893453

Public

boolean
/ Required
isPublicTrue if the project is public to its team.

Name

string
nameName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.Example - Populate customers page with live data

Notes

text
notesFree-form textual information associated with the object (ie., its description).These are some example notes.

Owner Id

string
/ Required
ownerProvide the unique identifier of the owner of the project.375893453

Project Color

string
projectColorProvide the default color for your project.light-green

Start On

string
startOnThe 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 format2021-11-14

Status Update Color

string
/ Required
statusUpdateColorThe color associated with the status update.green

Status Update Text

string
/ Required
statusUpdateTextThe text content of the status update.The project is moving forward according to plan.

Status Update Title

string
/ Required
statusUpdateTitleThe title of the project status update.Example Status Update - Jun 15

Team

string
teamThe 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.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "89754368332",      "archived": false,      "color": "light-green",      "custom_fields": {},      "default_view": "calendar",      "followers": [        {          "guid": "487535349",          "name": "Example User",          "resource_type": "user"        }      ],      "is_template": false,      "members": [        {          "guid": "394375092234",          "name": "Example User",          "resource_type": "user"        }      ],      "name": "MyProject",      "notes": "These are my project notes!",      "owner": {        "guid": "432934564345",        "name": "Example User",        "resource_type": "user"      },      "public": true    }  ]}

Create Project In Workspace#

Create a new project inside of an existing workspace | key: createProjectsInWorkspace

InputKeyNotesExample

Archived

boolean
archivedTrue 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.

Author

string
authorProvide a string value for the name of the author. You can also provide the unique identifier of a user who belongs to the same organization/workspace.John Doe

Created By

string
createdByThis name represents an account in Asana that created the object. You can also provide a user Id or email.John Doe

Default View

string
defaultViewThe default view of the project.

Due On

string
dueOnThe 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.2019-09-15

Followers

string
followersProvide a comma separated string of users.8570756435,375893453

Public

boolean
/ Required
isPublicTrue if the project is public to its team.

Name

string
nameName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.Example - Populate customers page with live data

Notes

text
notesFree-form textual information associated with the object (ie., its description).These are some example notes.

Owner Id

string
/ Required
ownerProvide the unique identifier of the owner of the project.375893453

Project Color

string
projectColorProvide the default color for your project.light-green

Start On

string
startOnThe 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 format2021-11-14

Status Update Color

string
/ Required
statusUpdateColorThe color associated with the status update.green

Status Update Text

string
/ Required
statusUpdateTextThe text content of the status update.The project is moving forward according to plan.

Status Update Title

string
/ Required
statusUpdateTitleThe title of the project status update.Example Status Update - Jun 15

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "89754368332",      "archived": false,      "color": "light-green",      "custom_fields": {},      "default_view": "calendar",      "followers": [        {          "guid": "487535349",          "name": "Example User",          "resource_type": "user"        }      ],      "is_template": false,      "members": [        {          "guid": "394375092234",          "name": "Example User",          "resource_type": "user"        }      ],      "name": "MyProject",      "notes": "These are my project notes!",      "owner": {        "guid": "432934564345",        "name": "Example User",        "resource_type": "user"      },      "public": true    }  ]}

Create Task#

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

InputKeyNotesExample

Approval Status

string
/ Required
approvalStatusProvide a string value for the approval status of the task.Pending

Assignee Id

string
/ Required
assigneeIdProvide the unique identifier of the assignee.843750385

Assignee Section Id

string
assigneeSectionIdProvide 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.843750385

Assignee Status

string
assigneeStatusProvide 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.upcoming

Completed By

string
completedByProvide a string value for the name of the user who completed the task. You can also provide a userId, or email.John Doe

Due At

string
dueAtProvide an ISO 8601 date string in UTC and should NOT be used together with Due On.2019-09-15T02:06:58.147Z

Due On

string
dueOnThe 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.2019-09-15

Followers List

string
followersListFor each item, provide the unique identifier of an existing userId.843750385

Completed

boolean
isCompletedTrue if the project is completed, false if not. This properties value is configured conditionally on the value of the Approval Status property.

Is Liked

boolean
isLikedThis flag will mark the specified task as 'liked' in your Asana account.

Name

string
nameName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.Example - Populate customers page with live data

Notes

text
notesFree-form textual information associated with the object (ie., its description).These are some example notes.

Parent Id

string
parentIdProvide the unique identifier of the parent element.843750385

Project List

string
projectListFor each item, provide the unique identifier of the project.843750385

Resource Subtype

string
resourceSubtypeProvide a string value for the type of object.task

Start On

string
startOnThe 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 format2021-11-14

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Every task is required to be created in a specific workspace, and this workspace cannot be changed once set. The workspace need not be set explicitly if you specify projects or a parent task instead.

For more information refer to the Asana Docs

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

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

Create Team#

Create a new team | key: createTeam

InputKeyNotesExample

Organization Id

string
/ Required
organizationIdProvide the unique identifier of the organization.375893453

Description

string
teamDescriptionProvide a string value for the description of the team.This is an example description

Name

string
/ Required
teamNameProvide a string value for the name of the team.Engineering Team

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Delete Project#

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

InputKeyNotesExample

Project Id

string
/ Required
projectIdProvide the unique identifier of the project.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": {}}

Delete Task#

Delete an existing task | key: deleteTask

InputKeyNotesExample

Task Id

string
/ Required
taskIdProvide the unique identifier for the task.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Get Project#

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

InputKeyNotesExample

Project Id

string
/ Required
projectIdProvide the unique identifier of the project.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "89754368332",      "archived": false,      "color": "light-green",      "custom_fields": {},      "default_view": "calendar",      "followers": [        {          "guid": "487535349",          "name": "Example User",          "resource_type": "user"        }      ],      "is_template": false,      "members": [        {          "guid": "394375092234",          "name": "Example User",          "resource_type": "user"        }      ],      "name": "MyProject",      "notes": "These are my project notes!",      "owner": {        "guid": "432934564345",        "name": "Example User",        "resource_type": "user"      },      "public": true    }  ]}

Get Task#

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

InputKeyNotesExample

Task Id

string
/ Required
taskIdProvide the unique identifier for the task.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

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

Get Team#

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

InputKeyNotesExample

Team Id

string
/ Required
teamIdProvide the unique identifier of the team.843750385

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": {    "guid": "4353535343",    "name": "Example Team",    "organization": {      "guid": "485983543",      "name": "Example Organization",      "resource_type": "workspace"    }  }}

Get User#

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

InputKeyNotesExample

User Id

string
/ Required
userIdProvide a unique identifier for the user375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": {    "guid": "57034734553",    "email": "someone@example.prismatic.io",    "name": "Example User",    "photo": null,    "resource_type": "user",    "workspaces": [      {        "guid": "947603953453",        "name": "Example Workspace",        "resource_type": "workspace"      }    ]  }}

Get Workspace#

Get the content and metadata of a Workspace by Id | key: getWorkspace

InputKeyNotesExample

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


List Projects#

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

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "0e750873053",      "name": "ExampleProjectName",      "resource_type": "project"    },    {      "guid": "0e750873053",      "name": "ExampleProjectName",      "resource_type": "project"    },    {      "guid": "0e750873053",      "name": "ExampleProjectName",      "resource_type": "project"    }  ]}

List Tasks#

Return a list of all the tasks connected to your Asana account | key: listTasks

InputKeyNotesExample

Assignee Id

string
/ Required
assigneeIdProvide the unique identifier of the assignee.843750385

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "458738457453",      "name": "Example Task",      "resource_type": "task"    },    {      "guid": "458738457453",      "name": "Example Task",      "resource_type": "task"    },    {      "guid": "458738457453",      "name": "Example Task",      "resource_type": "task"    }  ]}

List Users#

List all the users connected to a given workspace | key: listUsers

InputKeyNotesExample

Workspace Id

string
/ Required
workspaceIdProvide a unique identifier for the workspace.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "54630745323",      "name": "Example User",      "resource_type": "user"    },    {      "guid": "54630745323",      "name": "Example User",      "resource_type": "user"    },    {      "guid": "54630745323",      "name": "Example User",      "resource_type": "user"    }  ]}

List Workspaces#

Return a list of all workspaces connected to your account | key: listWorkspaces

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri


Update Project#

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

InputKeyNotesExample

Archived

boolean
archivedTrue 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.

Author

string
authorProvide a string value for the name of the author. You can also provide the unique identifier of a user who belongs to the same organization/workspace.John Doe

Created By

string
createdByThis name represents an account in Asana that created the object. You can also provide a user Id or email.John Doe

Default View

string
defaultViewThe default view of the project.

Due On

string
dueOnThe 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.2019-09-15

Followers

string
followersProvide a comma separated string of users.8570756435,375893453

Public

boolean
/ Required
isPublicTrue if the project is public to its team.

Name

string
nameName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.Example - Populate customers page with live data

Notes

text
notesFree-form textual information associated with the object (ie., its description).These are some example notes.

Owner Id

string
ownerProvide the unique identifier of the owner of the project.375893453

Project Color

string
projectColorProvide the default color for your project.light-green

Project Id

string
/ Required
projectIdProvide the unique identifier of the project.375893453

Start On

string
startOnThe 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 format2021-11-14

Status Update Color

string
/ Required
statusUpdateColorThe color associated with the status update.green

Status Update Text

string
/ Required
statusUpdateTextThe text content of the status update.The project is moving forward according to plan.

Status Update Title

string
/ Required
statusUpdateTitleThe title of the project status update.Example Status Update - Jun 15

Team

string
teamThe 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.375893453

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

{  "data": [    {      "guid": "89754368332",      "archived": false,      "color": "light-green",      "custom_fields": {},      "default_view": "calendar",      "followers": [        {          "guid": "487535349",          "name": "Example User",          "resource_type": "user"        }      ],      "is_template": false,      "members": [        {          "guid": "394375092234",          "name": "Example User",          "resource_type": "user"        }      ],      "name": "MyProject",      "notes": "These are my project notes!",      "owner": {        "guid": "432934564345",        "name": "Example User",        "resource_type": "user"      },      "public": true    }  ]}

Update Task#

Update the contents and metadata of an existing task by Id | key: updateTask

InputKeyNotesExample

Approval Status

string
approvalStatusProvide a string value for the approval status of the task.Pending

Assignee Id

string
assigneeIdProvide the unique identifier of the assignee.843750385

Assignee Section Id

string
assigneeSectionIdProvide 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.843750385

Assignee Status

string
assigneeStatusProvide 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.upcoming

Completed By

string
completedByProvide a string value for the name of the user who completed the task. You can also provide a userId, or email.John Doe

Due At

string
dueAtProvide an ISO 8601 date string in UTC and should NOT be used together with Due On.2019-09-15T02:06:58.147Z

Due On

string
dueOnThe 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.2019-09-15

Followers List

string
followersListFor each item, provide the unique identifier of an existing userId.843750385

Completed

boolean
isCompletedTrue if the project is completed, false if not. This properties value is configured conditionally on the value of the Approval Status property.

Is Liked

boolean
isLikedThis flag will mark the specified task as 'liked' in your Asana account.

Name

string
nameName of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability.Example - Populate customers page with live data

Notes

text
notesFree-form textual information associated with the object (ie., its description).These are some example notes.

Parent Id

string
parentIdProvide the unique identifier of the parent element.843750385

Project List

string
projectListFor each item, provide the unique identifier of the project.843750385

Resource Subtype

string
resourceSubtypeProvide a string value for the type of object.task

Start On

string
startOnThe 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 format2021-11-14

Task Id

string
/ Required
taskIdProvide the unique identifier for the task.375893453

Workspace Id

string
workspaceIdProvide a unique identifier for the workspace.375893453

Completed by, approval status, and isCompleted cannot be updated in the same request. If you attempt do do this you will likely receive a 400 back from Asana.

Authorization#

Authorization is required for this action.
Auth TypeKeyDescriptionFields
API Keyapi_keyAPI authorization based on an API key

API Key |  api_key

OAuth 2.0 - Authorization Codeoauth2OAuth 2.0 authorization using the authorization code grant type

Client ID |  client_id

Client Secret |  client_secret

Scopes |  scopes

Authorization URL |  auth_uri

Access Token URL |  token_uri

Output Example Payload#

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