Asana Pipe

This article is still being written, please check back soon.

Keep remote and distributed teams, and your entire organization, focused on their goals, projects, and tasks with Asana. The Asana API is a RESTful interface, providing programmatic access to much of the data in the system. It provides predictable URLs for accessing resources, and uses built-in HTTP features to receive commands and return responses.

Create an account here: https://asana.com/create-account

Get API Key:

Log into your asana.com account.
You can generate a Personal Access Token from the Asana developer console.

Note: You can generate Client Id and Client Secret with help of creating new App from the Asana developer console.

Global Parameters

There are 2 Global Parameters in this pipe.

Auth-Id
Authorization

API Calls

All the API Calls in this Pipe can be customized, but we've added several to help you get started and expedite the time needed to get you up and running with some of the basic uses.

Projects

Create a Project
Update a Project
Add User to Project
View a Project
Delete a Project

Create a Project

Create a new project in a workspace or team. Every project is required to be created in a specific workspace or organization, and this cannot be changed once set.

URL

First you can pass a URL and Method in the overview tab for create a new Project. The required URL and method that must be included below :

Method : POST
Request URL : https://tadapipes.tadabase.io/proxy/asana/projects

Parameters

Add required parameters values for dynamically assigned in the API Call request. Set required Parameters must be included in parameters tab.

name - The Project's name ( Required ).
color - Color of the project ( Required ).
workspace - Workspace Unique identifier ( Required ).

Headers

Here required header value must be included in headers tab. Assign parameter is {Auth-Id}, {Authorization} that created at global parameter tab.

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for creating a project. Here {name}, {color} and {workspace} is assigned parameters that created in parameters tab.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Using data from this test we can begin generating and response data. Successful response has 201 status.

Response

Built in responses already added are below.

Project Id
Resource type
Created at
Modified at
Due date
Current status
Public
Name

Update a Project

A specific, existing project can be updated by making a PUT request on the URL for that project.

URL

First you can pass a URL and Method in the overview tab for update a project. The required URL and method that must be included below :

Method :PUT
Request URL : https://tadapipes.tadabase.io/proxy/asana/projects/{project_gid}

Parameters

Set Parameters must be included in parameters tab.

project_gid - Project Unique identifier( Required )
name - The Project's name ( Required ).
color - Color of the project ( Required ).

Headers

There are 3 header Parameters must be included below.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for update a project. Here {name} and {color} is assign parameter. here change name of project and color.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

Built in responses already added are below.

Project Id
Resource type
Created at
Modified at
Due date
Current status
Public
Name

Add Users To a Project

Adds the specified list of users as members of the project. Returns the updated project record.

URL

First you can pass a URL and Method in the overview tab for add a users to project. The required URL and method that must be included below :

Method: POST
Request URL: https://tadapipes.tadabase.io/proxy/asana/projects/{project_gid}/addMembers

Parameters

Set required Parameters must be included in parameters tab.

project_gid - Project Unique identifier( Required ).
members - Users Unique identifier like email or gid ( Required ).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for add users to project. Here {members} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

Here response is not set because of add users list in array form in object result (not support more then one result).

View a Project

Returns the complete project record for a single project

URL

First you can pass a URL and Method in the overview tab for details of Project. The required URL and method that must be included below :

Method: GET
Request URL: https://tadapipes.tadabase.io/proxy/asana/projects/{project_gid}

Parameters

Set required Parameters must be included in parameters tab.

project_gid - Project Unique identifier( Required )

Headers

There are 2 header Parameters must be included below.

Auth-Id
Authorization

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 OK status.

Response

Built in responses already added are below.

Project Id
Resource type
Created at
Modified at
Due date
Current status
Public
Name

Delete a Project

A specific, existing project can be deleted by making a DELETE request on the URL for that project. Returns an empty data record.

URL

First you can pass a URL and Method in the overview tab for remove project. The required URL and method that must be included below :

Method: DELETE
Request URL: https://tadapipes.tadabase.io/proxy/asana/projects/{project_gid}

Parameters

Set required Parameters must be included in parameters tab.

project_gid - Project Unique identifier( Required )

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank and returns an empty response. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty response.

Tasks

Create a Task
Update a Task
Get a Task
Delete a Task

Create a Task

Create a new project in a workspace. 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.

URL

First you can pass a URL and Method in the overview tab for create a new Task. The required URL and method that must be included below :

Method : POST
Request URL : https://tadapipes.tadabase.io/proxy/asana/tasks

Parameters

Add required parameters values for dynamically assigned in the API Call request. Set required Parameters must be included in parameters tab.

projects - Unique identifier of Project Like Gid ( Required ).
name - New name of Task ( Required ).
html_notes - The notes of the text with formatting as HTML (Optional).
approval_status - Conditional Reflects the approval status of this task(completed, pending, approved, rejected).
workspace - Workspace Unique identifier ( Required ).
assignee - Unique identifier of a user like Gid or email ( Required ).
due_on - This takes a date with YYYY-MM-DD format ( Required ).

Headers

There are 3 header Parameters must be included below.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for create new task. Here {projects}, {name}, {html_notes}, {workspace}, {assignee} and {due_on} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 201 status.

Response

Built in responses already added are below.

Task id
Project Name
Project Id
Title
Description
Due on
Completed
Workspace
Assignee To

Update a Task

A specific, existing task can be updated by making a PUT request on the URL for that task.

URL

First you can pass a URL and Method in the overview tab for update a Task details. The required URL and method that must be included below :

Method :PUT
Request URL : https://tadapipes.tadabase.io/proxy/asana/tasks/{task_gid}

Parameters

Set Parameters must be included in parameters tab.

assignee - Unique identifier of a user like Gid or email ( Required ).
due_on - This takes a date with YYYY-MM-DD format ( Required ).
completed - Allow true or false.
task_gid - Unique identifier of a task like Gid ( Required ).

Headers

There are 3 header Parameters must be included below.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for updating task details. Here {assignee}, {completed} and {due_on} is assign parameter. Here change value of assignee, due on and completed in task.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

Built in responses already added are below.

Task id
Project Name
Project Id
Title
Description
Due on
Completed
Workspace
Assignee To

View a Task

Returns the complete task record for a single task.

URL

First you can pass a URL and Method in the overview tab for details of Task. The required URL and method that must be included below :

Method: GET
Request URL: https://tadapipes.tadabase.io/proxy/asana/tasks/{task_gid}

Parameters

Set required Parameters must be included in parameters tab.

task_gid- Task Unique identifier ( Required ).

Headers

There are 2 header Parameters must be included below.

Auth-Id
Authorization

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 OK status.

Response

Built in responses already added are below.

Task id
Project Name
Project Id
Title
Description
Due on
Completed
Workspace
Assignee To

Delete a Task

A specific, existing task can be deleted by making a DELETE request on the URL for that task. Deleted tasks go into the “trash” of the user making the delete request. Tasks can be recovered from the trash within a period of 30 days; afterward they are completely removed from the system.

URL

First you can pass a URL and Method in the overview tab for remove Task. The required URL and method that must be included below :

Method: DELETE
Request URL: https://tadapipes.tadabase.io/proxy/asana/tasks/{task_gid}

Parameters

Set required Parameters must be included in parameters tab.

task_gid - Task Unique identifier ( Required ).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank and returns an empty response. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty response.

Jobs

Get a Jobs by Id

Get a Jobs By Id

Returns the full record for a job.

URL

First you can pass a URL and Method in the overview tab for details of jobs. The required URL and method that must be included below :

Method: GET
Request URL: https://tadapipes.tadabase.io/proxy/asana/jobs/{job_gid}

Parameters

Set required Parameters must be included in parameters tab.

job_gid- Jobs Unique identifier( Required )

Headers

There are 2 header Parameters must be included below.

Auth-Id
Authorization

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

Built in responses already added are below.

Job id
Resource Type
Project Id
Project resource
Project name
Task id
Task resource
Task name
Resource subtype
Status

Portfolios

Create a Portfolios
Update a Portfolios
Delete a Portfolios
Get a Portfolios
Add a Portfolios Item
Remove a Portfolios Item
Add User to Portfolios
Remove a Users to Portfolios

Note: Portfolios are only available for users in an Enterprise or Business plan.

Create a Portfolios

Creates a new portfolio in the given workspace with the supplied name.

URL

First you can pass a URL and Method in the overview tab for create a new Portfolios. The required URL and method that must be included below :

Method : POST
Request URL : https://tadapipes.tadabase.io/proxy/asana/portfolios

Parameters

Add required parameters values for dynamically assigned in the API Call request. Set required Parameters must be included in parameters tab.

name - New name of Portfolios ( Required ).
workspace - Workspace Unique identifier ( Required ).
members - Unique identifier of a member like Gid or email ( Required ).
color - Color of the project ( Required ).

Headers

There are 3 header Parameters must be included below.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for create new Portfolios. Here {color}, {name}, {members} and {workspace} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 201 status.

Response

Built in responses already added are below.

Id
Name
Color
Created at
Workspace Id
Workspace name
Start on
Member id
Member name

Update a Portfolios

An existing portfolio can be updated by making a PUT request on the URL for that portfolio. Only the fields provided in the data block will be updated; any unspecified fields will remain unchanged.

URL

First you can pass a URL and Method in the overview tab for update a portfolio details. The required URL and method that must be included below :

Method :PUT
Request URL : https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}

Parameters

Set Parameters must be included in parameters tab.

portfolio_gid - Portfolios Unique identifier ( Required ).
name - New name of Portfolios ( Required ).
workspace - Workspace Unique identifier ( Required ).
members - Unique identifier of a member like Gid or email.
color - Color of the project.

Headers

There are 3 header Parameters must be included below.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for updating task details. Here {color}, {name}, {members} and {workspace} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

Built in responses already added are below.

Id
Name
Color
Created at
Workspace Id
Workspace name
Start on
Member id
Member name

Delete a Portfolios

An existing portfolio can be deleted by making a DELETE request on the URL for that portfolio.

URL

First you can pass a URL and Method in the overview tab for remove Portfolio. The required URL and method that must be included below :

Method: DELETE
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier ( Required ).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank and returns an empty response. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty response.

Get a Portfolios

Returns the complete portfolio record for a single portfolio.

URL

First you can pass a URL and Method in the overview tab for details of portfolios. The required URL and method that must be included below :

Method: GET
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier( Required )

Headers

There are 2 header Parameters must be included below.

Auth-Id
Authorization

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 status.

Response

uilt in responses already added are below.

Id
Name
Color
Created at
Workspace Id
Workspace name
Start on
Member id
Member name

Add a Portfolio Item

Add an item to a portfolio. Returns an empty data block.

URL

First you can pass a URL and Method in the overview tab for add a item to portfolios. The required URL and method that must be included below :

Method: POST
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}/addItem

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier( Required ).
insert_after - An id of an item in this portfolio.
insert_before - An id of an item in this portfolio.
item - Item Unique identifier (Required).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for add item to portfolio. Here {item}, {insert_after} and {insert_before} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty object response.

Remove a Portfolio Item

Remove an item from a portfolio. Returns an empty data block.

URL

First you can pass a URL and Method in the overview tab for remove a item from portfolios. The required URL and method that must be included below :

Method: POST
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}/removeItem

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier ( Required ).
item - Item Unique identifier (Required).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for delete item from portfolio. Here {item} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty object response.

Add Users to Portfolio

Adds the specified list of users as members of the portfolio. Returns the updated portfolio record.

URL

First you can pass a URL and Method in the overview tab for add a users to portfolios. The required URL and method that must be included below :

Method: POST
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}/addMembers

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier ( Required ).
members - Member Unique identifier like gid or email (Required).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for add user to portfolio. Here {members} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty object response.

Remove a Users from a Portfolio

Removes the specified list of users from members of the portfolio. Returns the updated portfolio record.

URL

First you can pass a URL and Method in the overview tab for remove a users from portfolios. The required URL and method that must be included below :

Method: POST
Request URL: https://tadapipes.tadabase.io/proxy/asana/portfolios/{portfolio_gid}/removeMembers

Parameters

Set required Parameters must be included in parameters tab.

portfolio_gid - Portfolio Unique identifier( Required ).
members - Member Unique identifier like gid or email (Required).

Headers

There are 3 header Parameters must be required.

Auth-Id
Authorization
Accept - application/json

Request

Now assigned dynamic parameters in a JSON object in the request tab with the data you want to use for delete users from portfolio. Here {members} is assign parameter.

Test

Now You can test this API call directly within the API Call test tab. There are parameters for all these values and the request must not be blank. Successful response has 200 No Content status.

Response

Here data mapping is not possible because of returns an empty object response.

Sections

Create a Sections
Update a Sections
Delete a Sections
Get a Sections
Add a Task to Sections

Note: Sections are only available for users in an Enterprise or Business plan.

More Details

To learn more about this Pipe and the additional API Methods, please see this article: https://developers.asana.com/docs/

Did this page help you?

Back to top