# Linear API

**Provider:** Linear
**Category:** developer
**Base URL:** `https://api.linear.app/graphql`
**Auth:** bearer — `Authorization: Bearer lin_api_...`
**Rate Limit:** 1,500 requests/hour
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://developers.linear.app/docs

## Description

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.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://api.linear.app/graphql/` | issues query — list and filter issues |
| POST | `https://api.linear.app/graphql/` | issue mutation — create, update, or archive an issue |
| POST | `https://api.linear.app/graphql/` | teams query — list all teams and their workflow states |
| POST | `https://api.linear.app/graphql/` | projects query — list projects with status and progress |
| POST | `https://api.linear.app/graphql/` | cycles query — list sprints (cycles) for a team |
| POST | `https://api.linear.app/graphql/` | comments mutation — add a comment to an issue |

## Authentication

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

```
Authorization: Bearer lin_api_...
```

## Sample Request

```bash
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

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

## Pricing Details

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

---

*Source: [API Map](https://apimap.dev/apis/linear/) — CC BY 4.0*