Linear GraphQL API

GraphQL discovered

Details

Endpoint: https://api.linear.app/graphql
Spec: https://raw.githubusercontent.com/linear/linear/master/packages/sdk/src/schema.graphql
Docs: https://linear.app/developers/graphql

Authentication

Linear OAuth application Authorization: Bearer <credential> + Linear personal API key Authorization: <credential> discovered

Linear OAuth application oauth2 Set up OAuth ↗

Create an OAuth2 Application, configure its redirect callback URLs, then run the standard Linear OAuth flow to obtain access tokens for users or workspace app installations. For agent/service-account style installs, include actor=app in the authorization request as described in Getting Started for Agents.

Linear personal API key api_key Get key ↗

In Linear, open Security & Access. Create a personal API key there. Depending on workspace policy, admins may need to allow member API keys; admins can always create them. Keys can be scoped to permissions like Read, Write, Admin, Create issues, and Create comments, and can be limited to specific teams.