Asana

By integrating Asana with DX, you can analyze issue data, cycle time metrics, and projects. Please refer to the API documentation below and our schema explorer to see what data DX imports.

Prerequisites

To connect Asana to DX, you need:

an Asana service account

Setup instructions

Follow the steps below to connect Asana to DX.

Step 1

Create an Asana service account to be used for DX, and ensure that the service account is granted access to the projects that you want to import into DX.

Step 2

Navigate to My apps in Asana, and click create a new token with the name “DX”.

Step 3

Navigate to the connections page in DX and select “+ Connection” in the top right.
Enter the credentials you have generated in the previous steps—refer to the information below for errors and troubleshooting.

API reference

The table below lists the specific API endpoints that are used by DX.

Endpoint	Documentation
/workspaces	Link
/workspaces/{workspace_id}/tasks/search	Link
/users	Link
/teams/{team_id}/projects	Link
/workspaces/{workspace_id}/teams	Link
/teams/{team_id}/team_memberships	Link
/projects/	Link
/tasks/{task_id}/status_updates	Link
/tasks/{task_id}/stories	Link
/projects/{project_id}/sections	Link
/workspaces/{workspace_id}/custom_fields	Link

Errors

The table below lists potential error codes when adding a connection in DX.

Error	Description
`invalid_credentials`	Your API credentials entered are not valid.
`invalid_permissions`	Your API token does not have the permissions required by DX.
`no_resources`	DX cannot access any projects or repositories.