Skip to content →


New updates and improvements to Linear.

API improvements

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.

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