Linear

By integrating Linear 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 Linear to DX, you need:

an Linear service account
a personal API key

Setup instructions

Follow the steps below to connect Linear to DX.

Step 1

Create an Linear 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

Once signed in to the service account, browse to account settings and generate a new Personal API key.

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.

Operation Name	Type	Documentation
teams	Query	Link
projects	Query	Link
issueLabels	Query	Link
workflowStates	Query	Link
issues	Query	Link
users	Query	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`	Your service account does not have access to any projects.