megachangelog
Breaking

API improvements

Linear's GraphQL API now implements Relay-style cursor-based pagination for all list responses with optional archived resource filtering and a new viewer query. This breaking change future-proofs the API with more stable building blocks for integrations.

API improvements Linear is built on our GraphQL API which is also available to our users through personal API keys. As we have evolved the application, the API has evolved as well. This week we're releasing larger breaking changes to future proof the API and provide more stable building blocks for the future. Pagination All list responses from queries now return paginated results instead of a list. We implement Relay style cursor-based pagination model with first/after and last/before pagination arguments. To simply query get first 10 issues for your organization: The first 50 results are returned by default without query arguments. Pagination also supports simpler syntax where instead of edges you can directly get all the nodes similar to GitHub's GraphQL API: Archived resources Archived resources are now hidden by default from the paginated responses. They can be included by passing optional includeArchived: true as a query parameter. New viewer query To get the currently logged in user, we also added a simpler viewer query: Other improvements and fixes: Fixed a bug in team archiving which lead to client crashes in certain situations
apigraphqlpaginationbreaking

Source: original entry ↗

More from Linear

Follow Linear to get its new changes in your feed and email digest.

Feature

New controls for Linear coding agent

Linear Agent now offers adaptive routing to optimize model selection by task complexity, environment secrets support for secure dependency access, and open-weight model options including GLM. Teams can define custom project labels and statuses, assign project leads, use durable IDs for projects and initiatives, and automate workflows with new team-based triggers for onboarding and reassignment.

agentcodingworkflowsteamsautomation
Feature

Loops for product management with expanded workspace triggers and document editing

Loops, Linear's recurring agent workflows, now respond to more workspace activity including project, initiative, and cycle changes, can edit Linear documents and post updates to Slack. This helps teams automate coordination tasks like updating docs and keeping stakeholders informed when plans change.

automationloopsworkflowcollaborationslack
Feature

Priority inbox and new mobile features

Linear now offers a Priority tab that intelligently separates urgent notifications from less critical ones, preventing important items like release-blocking reviews from getting lost. Additionally, document editing is now available on iOS and Android, rich previews render in diffs, draft projects with Linear Agent for planning, and admins can approve third-party app access on paid plans.

inboxnotificationsmobiledocumentsai-agent
See all Linear changes →