Skip to content
For LLMsView as Markdown·

Linear

Streamlined issue tracking and project management with the Linear API.

DetailValue
CategoryProject Management
Base URLhttps://api.linear.app
AuthenticationBearer Token
Endpoints5
Connector keylinear

Using Linear in a workflow

  1. Go to Connections and click New Connection.
  2. Pick Linear from the marketplace.
  3. Enter your credentials (see Authentication above for what's expected).
  4. In a workflow, drop an API Call node and select this connection.
  5. Pick the operation you need from the Operation dropdown — the full list is below.

Available endpoints

EndpointSummary
POST /graphqlQuery issues via GraphQL
POST /graphqlCreate an issue via GraphQL mutation
POST /graphqlUpdate an issue via GraphQL mutation
POST /graphqlList projects via GraphQL
POST /graphqlList teams via GraphQL

Each endpoint is documented in full below. Use the outline on the right to jump to one.

POST /graphql

Query issues via GraphQL

DetailValue
Operation IDpm.queryIssues
MethodPOST
Path/graphql

Parameters

No parameters.

Request Body

FieldType
querystring
variablesobject

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Linear connection from the Connection dropdown.
  3. In the Operation dropdown, select pm.queryIssues.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Linear API reference.

POST /graphql

Create an issue via GraphQL mutation

DetailValue
Operation IDpm.createIssue
MethodPOST
Path/graphql

Parameters

No parameters.

Request Body

FieldType
querystring
variablesobject

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Linear connection from the Connection dropdown.
  3. In the Operation dropdown, select pm.createIssue.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Linear API reference.

POST /graphql

Update an issue via GraphQL mutation

DetailValue
Operation IDpm.updateIssue
MethodPOST
Path/graphql

Parameters

No parameters.

Request Body

FieldType
querystring
variablesobject

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Linear connection from the Connection dropdown.
  3. In the Operation dropdown, select pm.updateIssue.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Linear API reference.

POST /graphql

List projects via GraphQL

DetailValue
Operation IDpm.listProjects
MethodPOST
Path/graphql

Parameters

No parameters.

Request Body

FieldType
querystring

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Linear connection from the Connection dropdown.
  3. In the Operation dropdown, select pm.listProjects.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Linear API reference.

POST /graphql

List teams via GraphQL

DetailValue
Operation IDpm.listTeams
MethodPOST
Path/graphql

Parameters

No parameters.

Request Body

FieldType
querystring

Using this endpoint in a workflow

  1. Add an API Call node to your workflow.
  2. Pick your Linear connection from the Connection dropdown.
  3. In the Operation dropdown, select pm.listTeams.
  4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked — fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Linear API reference.