What is the Linear API base URL?

The Linear API base URL is https://api.linear.app/graphql

Linear API — Base URL, Auth & Endpoints

Linear is a modern project management tool for software teams. Its GraphQL API gives full programmatic access to issues, projects, teams, cycles (sprints), comments, labels, and workflow states. Build automations, sync issues with external systems, create custom dashboards, and integrate Linear into your CI/CD workflow. Supports webhooks for real-time event streaming.

Quick Reference

Base URL https://api.linear.app/graphql Auth type Bearer Token Auth header Authorization: Bearer lin_api_... Rate limit 1,500 requests/hour Pricing Free tier available Free quota 250 MB storage Documentation https://developers.linear.app/docs Endpoint status Server online — HTTP 400 — server is online but path returned an error (may require auth)858ms (checked Mar 29, 2026) Builder score B 71% builder-friendly

Pricing

Latency

Depth

Authentication

Generate a Personal API Key in Linear Settings → API. Pass it as a Bearer token in the Authorization header.

Authorization: Bearer lin_api_...

Pricing

Model freemium Starting price Free tier available Free quota 250 MB storage

Plan	Price/mo	Included
Free	Free	250 issues, 250 MB storage
Basic	$8	Per user/mo, unlimited issues
Business	$16	Per user/mo, advanced automation
Enterprise	$0	Custom pricing, SSO, audit log

Free: 250 issues, 250MB storage. Basic: $8/user/mo. Business: $16/user/mo. Enterprise: custom pricing.

Key Endpoints

Method	Path	Description
POST	`/`	issues query — list and filter issues
POST	`/`	issue mutation — create, update, or archive an issue
POST	`/`	teams query — list all teams and their workflow states
POST	`/`	projects query — list projects with status and progress
POST	`/`	cycles query — list sprints (cycles) for a team
POST	`/`	comments mutation — add a comment to an issue

Sample Request

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

Sample Response

{
  "data": {
    "issues": {
      "nodes": [
        {
          "id": "issue_abc",
          "title": "Fix auth token refresh bug",
          "priority": 1,
          "assignee": { "name": "Alice Chen" }
        }
      ]
    }
  }
}