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.

2 APIs 16 Features

APIs

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 ...

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...

Collections

GraphQL

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

Linear Plans Pricing

4 plans

PLANS

Rate Limits

Linear Rate Limits

3 limits

RATE LIMITS

FinOps

Linear Finops

FINOPS

Features

Free plan: 2 teams, 250 issues, unlimited members
Basic at $10/user/mo: 5 teams, unlimited issues
Business at $16/user/mo: unlimited teams, Triage Intelligence, Linear Insights
Enterprise: SAML/SCIM, granular admin
GraphQL API at api.linear.app/graphql
API key rate limit: 1,500 req/hr
OAuth per-user rate limit: 1,200 req/hr
Complexity-based query budget: 250k points/hr
Webhooks for issue, comment, project events
Linear Agent platform for AI automations
OAuth 2.0 with granular scopes
Subscriptions for real-time updates over WebSocket
GitHub, GitLab, Slack, Sentry integrations
Triage Intelligence for incoming issue routing
Asks for converting Slack messages to issues
SCIM and SAML on Enterprise

Event Specifications

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

Linear Context

17 classes · 11 properties

JSON-LD

JSON Structure

Linear Structure

0 properties

JSON STRUCTURE

Example Payloads

Resources

🔗
LinkedIn
LinkedIn
🌐
Portal
Portal
🚀
GettingStarted
GettingStarted
🔑
Authentication
Authentication
🔗
RateLimits
RateLimits
📄
ChangeLog
ChangeLog
🔗
Deprecation Notice
Deprecation Notice
🔗
Migration Guide
Migration Guide
💬
Support
Support
🔗
Website
Website
📦
SDKs
SDKs
👥
GitHubOrganization
GitHubOrganization
👥
GitHubRepository
GitHubRepository
🔧
Developer Tools
Developer Tools
🔗
OpenAPI
OpenAPI
🔗
AsyncAPI
AsyncAPI
🔗
JSONSchema
JSONSchema
🔗
JSONLDContext
JSONLDContext
🔗
LlmsText
LlmsText

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Linear GraphQL API
  version: 2.0.0
request:
  auth:
    type: bearer
    token: '{{bearerToken}}'
items:
- info:
    name: GraphQL
    type: folder
  items:
  - info:
      name: Execute a GraphQL query or mutation
      type: http
    http:
      method: POST
      url: https://api.linear.app/graphql/graphql
      body:
        type: json
        data: '{}'
    docs: Send a GraphQL query or mutation to the Linear API. All operations (issues, projects, teams, cycles, roadmaps, comments,
      attachments) are performed through this single endpoint using GraphQL introspection.
- info:
    name: Attachments
    type: folder
  items:
  - info:
      name: Upload a file attachment
      type: http
    http:
      method: POST
      url: https://api.linear.app/graphql/graphql/upload
      body:
        type: multipart-form
        data:
        - name: file
          type: text
          value: ''
        - name: contentType
          type: text
          value: ''
    docs: Upload files for use as attachments on issues or comments. Returns a signed URL and asset URL for use in subsequent
      GraphQL mutations.
bundled: true