Linear website screenshot

Linear

Linear is an issue tracking and product development platform for software teams covering Intake, Plan, Build, Diffs (code review), and Monitor. The public developer surface is a GraphQL API at https://api.linear.app/graphql with OAuth 2.0 and personal API key auth, signed webhooks, a TypeScript SDK, an Agent SDK / Agent Interaction Guidelines for AI agents, and integrations with GitHub, Slack, Figma, Cursor, Codex, GitHub Copilot, and others. Serves 25,000+ product teams.

Linear publishes 4 APIs on the APIs.io network. Tagged areas include Project Management, Issue Tracking, Productivity, SaaS, and GraphQL.

Linear’s developer surface includes signup flow, documentation, API reference, authentication, pricing, changelog, engineering blog, and 25 more developer resources.

38.8/100 thin ▬ flat Agent 18/100 agent aware Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFree
4 APIs 13 Features
Project ManagementIssue TrackingProductivitySaaSGraphQLDeveloper ToolsAgents

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 38.8/100 · thin
Contract Quality 0.0 / 25
Developer Ergonomics 7.0 / 20
Commercial Clarity 16.3 / 20
Operational Transparency 9.9 / 13
Governance 0.0 / 12
Discoverability 5.6 / 10
Agent readiness — 18/100 · agent aware
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 6 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/linear-app: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 4

Individual APIs this provider publishes, each with its own machine-readable definition.

Linear GraphQL API

Single GraphQL endpoint exposing Linear's full data model - issues, projects, initiatives, cycles, teams, users, comments, documents, customers, customer requests, and more. Aut...

Linear Webhooks

Outbound webhooks for data-change events across Issues, Issue attachments, Issue comments, Issue labels, Comment reactions, Projects, Project updates, Documents, Initiatives, In...

Linear OAuth 2.0

OAuth 2.0 authorization-code and PKCE flows for third-party apps. Authorize at https://linear.app/oauth/authorize, exchange tokens at https://api.linear.app/oauth/token. Scopes ...

Linear Agents API

Capabilities for AI agents to operate as first-class actors inside Linear - Agent Interaction Guidelines (AIG), signals, and best-practice patterns for interacting with users an...

GraphQL 1

GraphQL schemas published by this provider.

Linear GraphQL API

Single GraphQL endpoint exposing Linear's full data model - issues, projects, initiatives, cycles, teams, users, comments, documents, customers, customer requests, and more. Aut...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Linear App Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 13

Notable capabilities this provider offers.

GraphQL API at https://api.linear.app/graphql with full introspection
OAuth 2.0 with PKCE plus personal API key auth
Strongly-typed TypeScript SDK (v2.x) with webhook helpers
HMAC-SHA256 signed webhooks via Linear-Signature header
15+ webhook resource types (Issues, Projects, Initiatives, Cycles, Customers, etc.)
Apollo Studio playground for live schema exploration
Agents framework with Agent Interaction Guidelines
Native integrations with GitHub, Slack, Figma, Sentry, Zendesk
AI agent integrations including Codex, GitHub Copilot, Cursor
Triage inbox for routing intake into actionable issues
Diffs for structural code review visualization
Mobile apps for iOS and Android
25,000+ product teams using Linear

Scroll for all 13

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Linear App Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Linear App Vulnerability Disclosure

security.txt · contact published

SECURITY

Linear App Trust Center

SOC 2, ISO 27001, HIPAA, GDPR

SECURITY

Resources

Get Started 2

Portal, sign-up, and the first successful call

Documentation 3

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

Build 3

SDKs, sample code, and the tooling you integrate with

Access & Security 6

Authentication, authorization, and security posture

Learn 1

Tutorials, courses, talks, and written guidance

Operate 4

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 3

The organization behind the API

Other 5

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
aid: linear-app
name: Linear
description: Linear is an issue tracking and product development platform for software teams covering Intake, Plan, Build,
  Diffs (code review), and Monitor. The public developer surface is a GraphQL API at https://api.linear.app/graphql with OAuth
  2.0 and personal API key auth, signed webhooks, a TypeScript SDK, an Agent SDK / Agent Interaction Guidelines for AI agents,
  and integrations with GitHub, Slack, Figma, Cursor, Codex, GitHub Copilot, and others. Serves 25,000+ product teams.
accessModel:
  pricing: free
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Free
  confidence: medium
  source:
  - plans
  generated: '2026-07-22'
  method: derived
image: https://linear.app/static/og/homepage.jpg
tags:
- Project Management
- Issue Tracking
- Productivity
- SaaS
- GraphQL
- Developer Tools
- Agents
created: '2026-05-23'
modified: '2026-05-23'
specificationVersion: '0.18'
position: Consuming
kind: contract
access: 3rd-Party
apis:
- aid: linear-app:linear-graphql-api
  name: Linear GraphQL API
  description: Single GraphQL endpoint exposing Linear's full data model - issues, projects, initiatives, cycles, teams, users,
    comments, documents, customers, customer requests, and more. Auth via OAuth 2.0 Bearer or personal API key. Schema is
    introspectable and explorable via Apollo Studio.
  tags:
  - GraphQL
  - Issues
  - Projects
  - Teams
  - Cycles
  - Comments
  properties:
  - url: https://linear.app/developers/graphql
    type: Documentation
  - url: https://linear.app/developers
    type: APIReference
  - url: https://api.linear.app/graphql
    type: BaseURL
  - url: https://linear.app/developers/oauth-2-0-authentication
    type: Authentication
  - url: graphql/linear-app-graphql.md
    type: GraphQL
- aid: linear-app:linear-webhooks
  name: Linear Webhooks
  description: Outbound webhooks for data-change events across Issues, Issue attachments, Issue comments, Issue labels, Comment
    reactions, Projects, Project updates, Documents, Initiatives, Initiative updates, Cycles, Customers, Customer Requests,
    Users, plus Issue SLA and OAuthApp revoked. Payloads are signed with HMAC-SHA256 in the Linear-Signature header.
  tags:
  - Webhooks
  - Events
  - Async
  properties:
  - url: https://linear.app/developers/webhooks
    type: Documentation
  - url: https://linear.app/settings/api
    type: Configuration
- aid: linear-app:linear-oauth
  name: Linear OAuth 2.0
  description: OAuth 2.0 authorization-code and PKCE flows for third-party apps. Authorize at https://linear.app/oauth/authorize,
    exchange tokens at https://api.linear.app/oauth/token. Scopes include read, write, issues:create, comments:create, timeSchedule:write,
    and admin.
  tags:
  - OAuth
  - Authentication
  - Authorization
  properties:
  - url: https://linear.app/developers/oauth-2-0-authentication
    type: Documentation
  - url: https://linear.app/oauth/authorize
    type: AuthorizationURL
  - url: https://api.linear.app/oauth/token
    type: TokenURL
- aid: linear-app:linear-agents-api
  name: Linear Agents API
  description: Capabilities for AI agents to operate as first-class actors inside Linear - Agent Interaction Guidelines (AIG),
    signals, and best-practice patterns for interacting with users and issues.
  tags:
  - Agents
  - AI
  - Automation
  properties:
  - url: https://linear.app/developers/agents
    type: Documentation
common:
- type: TrustCenter
  url: security/linear-app-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/linear-app-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/linear-app-domain-security.yml
- url: https://linear.app
  type: Website
- url: https://linear.app/signup
  type: Signup
- url: https://linear.app/login
  type: Login
- url: https://linear.app/docs
  type: Documentation
- url: https://linear.app/developers
  type: APIReference
- url: https://linear.app/developers/graphql
  type: APIReference
- url: https://linear.app/developers/oauth-2-0-authentication
  type: Authentication
- url: https://linear.app/developers/sdk
  type: SDKs
- url: https://linear.app/developers/webhooks
  type: Webhooks
- url: https://linear.app/developers/agents
  type: Agents
- url: https://linear.app/developers/rate-limiting
  type: RateLimits
- url: https://linearstatus.com/
  type: StatusPage
- url: https://linear.app/pricing
  type: Pricing
- url: https://linear.app/enterprise
  type: Enterprise
- url: https://linear.app/startups
  type: Startups
- url: https://linear.app/contact/sales
  type: Sales
- url: https://linear.app/security
  type: Security
- url: https://linear.app/privacy
  type: PrivacyPolicy
- url: https://linear.app/terms
  type: TermsOfService
- url: https://linear.app/dpa
  type: DPA
- url: https://linear.app/integrations
  type: Integrations
- url: https://linear.app/changelog
  type: ChangeLog
- url: https://linear.app/blog
  type: Blog
- url: https://linear.app/join-slack
  type: Slack
- url: https://github.com/linear
  type: GitHubOrganization
- url: https://github.com/linear/linear
  type: SourceCode
- url: https://x.com/linear
  type: X (Twitter)
- url: https://www.youtube.com/@linear
  type: YouTube
- url: https://linear.app/settings/api
  type: APIKeys
- type: Features
  data:
  - GraphQL API at https://api.linear.app/graphql with full introspection
  - OAuth 2.0 with PKCE plus personal API key auth
  - Strongly-typed TypeScript SDK (v2.x) with webhook helpers
  - HMAC-SHA256 signed webhooks via Linear-Signature header
  - 15+ webhook resource types (Issues, Projects, Initiatives, Cycles, Customers, etc.)
  - Apollo Studio playground for live schema exploration
  - Agents framework with Agent Interaction Guidelines
  - Native integrations with GitHub, Slack, Figma, Sentry, Zendesk
  - AI agent integrations including Codex, GitHub Copilot, Cursor
  - Triage inbox for routing intake into actionable issues
  - Diffs for structural code review visualization
  - Mobile apps for iOS and Android
  - 25,000+ product teams using Linear
  sources:
  - https://linear.app
  - https://linear.app/developers
  - https://linear.app/developers/graphql
  updated: '2026-05-23'
- type: LlmsText
  url: https://linear.app/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
- name: Linear
  url: https://linear.app