linear.app/developers

Build an AI agent that gets delegated a Linear issue, works an Agent Session, and reports structured progress back to the user

Verify that an incoming Linear webhook payload is authentic and not replayed, before an agent acts on it

Retrieve a file previously uploaded to Linear from its private storage instead of assuming assetUrl is publicly fetchable

Upload a file (image, log, artifact) to Linear's private cloud storage and reference it from an issue, comment, or attachment

Upload a file (image, log, artifact) to Linear's private cloud storage and reference it from an issue, comment, or attachment

Attach an external resource (PR, doc, dashboard link) to a Linear issue idempotently, so re-running the sync doesn't create duplicates

Catch and classify errors from the Linear GraphQL API/SDK so an agent can distinguish invalid input from auth, rate-limit, or transient failures

Query and mutate Linear data from a Node/TypeScript agent using the official @linear/sdk client instead of hand-written GraphQL

Filter Linear issues by state, assignee, label, priority, dates, and related-object fields using the GraphQL filter argument

Keep an agent's Linear API usage within request-rate and query-complexity limits, and recover cleanly when throttled

Paginate through large Linear result sets (issues, projects, comments) using Relay-style cursors instead of relying on a single query

Install and operate a Linear integration as a workspace app/service account (rather than as an individual user) using OAuth actor=app

Authenticate an AI agent's GraphQL requests to Linear using either a personal API key or an OAuth 2.0 access token