linear website screenshot

linear

Linear's public API is built using GraphQL. It's the same API we use internally for developing our applications. If you are new to GraphQL, Apollo has resources for beginners. The official GraphQL documentation is another good starting point.

linear publishes 3 APIs on the APIs.io network: Webhooks API, Attachments API, and GraphQL API.

The linear catalog on APIs.io includes 1 event-driven AsyncAPI specification, 1 JSON-LD context, and 2 Spectral governance rulesets.

linear’s developer surface includes authentication, engineering blog, and 5 more developer resources.

🌐 Visit website 📡 Source on GitHub
49.1/100 developing ▬ flat Agent 53/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessFreemiumSelf serve⚡ Free to try
3 APIs

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 49.1/100 · developing
Contract Quality 22.0 / 25
Developer Ergonomics 2.6 / 20
Commercial Clarity 9.5 / 20
Operational Transparency 4.1 / 13
Governance 5.0 / 12
Discoverability 5.9 / 10
Agent readiness — 53/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 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: 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 3

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

Linear Webhooks API

Linear webhooks deliver HTTP push notifications whenever data is created, updated, or removed. Webhooks are organization-scoped and can be configured for all public teams or a s...

linear Attachments API

File upload for issue and comment attachments

linear GraphQL API

Core GraphQL query and mutation endpoint

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Linear GraphQL API

OPEN COLLECTION

GraphQL 1

GraphQL schemas published by this provider.

linear GraphQL API

Linear's public GraphQL API provides full access to create, read, update, and query issues, projects, cycles, roadmaps, and teams. It is the same API Linear uses internally for ...

GRAPHQL

Pricing Plans 1

Published pricing tiers and plan structures.

Linear Plans Pricing

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Linear Rate Limits

3 limits

RATE LIMITS

FinOps 1

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

Linear Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Linear Webhooks API

Linear webhooks deliver HTTP push notifications whenever data is created, updated, or removed. Webhooks are organization-scoped and can be configured for all public teams or a s...

ASYNCAPI

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Linear Context

17 classes · 11 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

linear API Rules

5 rules · 1 errors 4 warnings

SPECTRAL

linear API Rules

6 rules · 4 warnings 2 info

SPECTRAL

JSON Schema 6

Standalone JSON Schema definitions for this provider's data models.

ErrorResponse

2 properties

JSON SCHEMA

FileUploadResponse

3 properties

JSON SCHEMA

GraphQLError

4 properties

JSON SCHEMA

GraphQLRequest

3 properties

JSON SCHEMA

GraphQLResponse

2 properties

JSON SCHEMA

Linear Issue

23 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Linear Structure

0 properties

JSON STRUCTURE

Examples 1

Example request and response payloads for these APIs.

Linear Executegraphqlquery Example

6 fields

EXAMPLE

Security Posture 4

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

Linear Authentication

http/oauth2 · 2 schemes

SECURITY

Linear Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Linear Vulnerability Disclosure

security.txt · contact published

SECURITY

Linear Trust Center

SOC 2, ISO 27001, HIPAA, GDPR

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Linear Scopes

4 scopes · authorizationCode

4 scopes

SCOPES

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Linear Agentic Access

2 operations · 2 acting

2 operations · 2 acting

AGENTIC

Resources

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess
AgenticAccess

Access & Security 5

Authentication, authorization, and security posture

TrustCenter
TrustCenter
 VulnerabilityDisclosure
VulnerabilityDisclosure
 DomainSecurity
DomainSecurity
 Authentication
Authentication
 OAuthScopes
OAuthScopes

Company 1

The organization behind the API

Blog
Blog

Source (apis.yml)

apis.yml Raw ↑ 
aid: linear
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/linear.png
url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/apis.yml
modified: '2026-05-19'
maintainer:
  name: Kin Lane
  email: kin@apievangelist.com
apis:
- aid: linear:linear-webhooks-api
  name: Linear Webhooks API
  tags:
  - Events
  - Real-Time
  - Webhooks
  image: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/image.png
  humanURL: https://linear.app/developers/webhooks
  baseURL: https://api.linear.app/graphql
  properties:
  - url: https://linear.app/developers/webhooks
    type: Documentation
  - url: https://linear.app/developers/sdk-webhooks
    type: GettingStarted
  - url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/asyncapi/linear-webhooks-asyncapi.yml
    type: AsyncAPI
  description: Linear webhooks deliver HTTP push notifications whenever data is created, updated, or removed. Webhooks are
    organization-scoped and can be configured for all public teams or a single team, enabling integrations that trigger CI
    builds, update external systems, or send messages based on issue activity.
- aid: linear:linear-attachments-api
  name: linear Attachments API
  description: File upload for issue and comment attachments
  humanURL: https://linear.app/developers/graphql
  baseURL: https://api.linear.app/graphql
  tags:
  - Attachments
  properties:
  - type: OpenAPI
    url: openapi/linear-attachments-api-openapi.yml
  - type: Documentation
    url: https://linear.app/developers/graphql
  - type: Reference
    url: https://studio.apollographql.com/public/Linear-API/schema/reference?variant=current
  - type: Authentication
    url: https://linear.app/developers/oauth-2-0-authentication
  - type: GettingStarted
    url: https://linear.app/developers/sdk
  - type: RateLimits
    url: https://linear.app/developers/rate-limiting
  - type: Pagination
    url: https://linear.app/developers/pagination
  - type: Filtering
    url: https://linear.app/developers/filtering
  - type: Deprecation Notice
    url: https://linear.app/developers/deprecations
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/json-schema/linear-issue-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/json-ld/linear-context.jsonld
  - type: GraphQL
    url: graphql/linear-graphql.md
- aid: linear:linear-graphql-api
  name: linear GraphQL API
  description: Core GraphQL query and mutation endpoint
  humanURL: https://linear.app/developers/graphql
  baseURL: https://api.linear.app/graphql
  tags:
  - GraphQL
  properties:
  - type: OpenAPI
    url: openapi/linear-graphql-api-openapi.yml
  - type: Documentation
    url: https://linear.app/developers/graphql
  - type: Reference
    url: https://studio.apollographql.com/public/Linear-API/schema/reference?variant=current
  - type: Authentication
    url: https://linear.app/developers/oauth-2-0-authentication
  - type: GettingStarted
    url: https://linear.app/developers/sdk
  - type: RateLimits
    url: https://linear.app/developers/rate-limiting
  - type: Pagination
    url: https://linear.app/developers/pagination
  - type: Filtering
    url: https://linear.app/developers/filtering
  - type: Deprecation Notice
    url: https://linear.app/developers/deprecations
  - type: JSONSchema
    url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/json-schema/linear-issue-schema.json
  - type: JSONLDContext
    url: https://raw.githubusercontent.com/api-evangelist/linear/refs/heads/main/json-ld/linear-context.jsonld
  - type: GraphQL
    url: graphql/linear-graphql.md
common:
- type: AgenticAccess
  url: agentic-access/linear-agentic-access.yml
- type: TrustCenter
  url: security/linear-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/linear-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/linear-domain-security.yml
- type: Authentication
  url: authentication/linear-authentication.yml
- type: OAuthScopes
  url: scopes/linear-scopes.yml
- url: https://linear.app/rss/now.xml
  type: Blog
description: Linear's public API is built using GraphQL. It's the same API we use internally for developing our applications.
  If you are new to GraphQL, Apollo has resources for beginners. The official GraphQL documentation is another good starting
  point.
integrations:
- name: Essentials
- name: Agents
- name: AI clients
- name: Engineering
- name: Linear crafted
- name: Bug Reporting
- name: Automations
- name: Customer Experience
- name: Security & Compliance
- name: Media & Design