Project Management API Key

Linear REST API

Modern issue tracking and project management API

Linear is a streamlined project management and issue tracking tool built for high-performance teams. The Linear API provides programmatic access to issues, projects, teams, cycles, and workflows, enabling developers to automate task creation, sync data across tools, and build custom integrations. Teams use the API to connect Linear with their development workflows, create custom dashboards, and automate project management tasks.

Base URL https://api.linear.app/graphql

API Endpoints

Method	Endpoint	Description
POST	`/graphql`	Query issues with filters and pagination
POST	`/graphql`	Create a new issue in a team
POST	`/graphql`	Update an existing issue's status, assignee, or properties
POST	`/graphql`	Get all teams in the workspace
POST	`/graphql`	Get project details and associated issues
POST	`/graphql`	Create a new project with milestones
POST	`/graphql`	Get workflow states for a team
POST	`/graphql`	Get cycle information and cycle issues
POST	`/graphql`	Add a comment to an issue
POST	`/graphql`	Get user details and assigned issues
POST	`/graphql`	Create and manage issue labels
POST	`/graphql`	Get roadmap and milestone data
POST	`/graphql`	Archive or delete issues
POST	`/graphql`	Search issues across the workspace
POST	`/graphql`	Get and update issue relationships and dependencies

Code Examples

curl -X POST https://api.linear.app/graphql \
  -H 'Authorization: Bearer lin_api_xxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "query": "query { issues(first: 10, filter: { state: { name: { eq: \"In Progress\" }}}) { nodes { id title identifier assignee { name } state { name } } } }"
  }'

const response = await fetch('https://api.linear.app/graphql', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer lin_api_xxxxxxxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    query: `
      mutation CreateIssue {
        issueCreate(input: {
          teamId: "team_xxxxxxxxxxxxx"
          title: "Fix authentication bug"
          description: "Users cannot log in with SSO"
          priority: 1
        }) {
          success
          issue {
            id
            identifier
            url
          }
        }
      }
    `
  })
});
const data = await response.json();
console.log(data);

import requests

url = 'https://api.linear.app/graphql'
headers = {
    'Authorization': 'Bearer lin_api_xxxxxxxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json'
}

query = '''
  query {
    teams {
      nodes {
        id
        name
        issues(first: 20) {
          nodes {
            id
            identifier
            title
            priority
            state {
              name
            }
          }
        }
      }
    }
  }
'''

response = requests.post(url, json={'query': query}, headers=headers)
data = response.json()
print(data)

Use Linear from Claude / Cursor / ChatGPT

Get a hosted MCP endpoint for Linear. Paste your Linear API key, copy back one URL, drop it into Claude Desktop, Cursor, or any AI client that supports remote MCP. Your AI calls Linear directly with your credentials — no local install, works on mobile.

create_linear_issue Create a new issue in Linear with title, description, team, priority, and assignee

search_linear_issues Search and filter Linear issues by status, assignee, labels, project, or text query

update_issue_status Update the workflow state of a Linear issue (e.g., move to In Progress, Done)

get_team_roadmap Retrieve project roadmap, milestones, and cycle information for a team

manage_issue_comments Add, update, or retrieve comments on Linear issues for collaboration

Connect in 60 seconds

Paste your Linear key → get an MCP URL → paste into Claude/Cursor. Hosted by IOX, encrypted at rest.

Connect Linear to your AI →

Linear REST API

API Endpoints

Sponsor this page

Code Examples

Use Linear from Claude / Cursor / ChatGPT

Connect in 60 seconds

Related APIs