Menu

Samenvatting van de Linear API

Met de Linear API koppel je het volledige werkproces van software-teams aan externe systemen. Eén GraphQL endpoint serveert issues, projecten, cycles, initiatives, documents, agents en customer requests, met fijnmazige permissions per OAuth-scope.
  • Issues en cycles: Volledige CRUD op issues, sub-issues, labels, relations, reminders, attachments en cycle-management inclusief batch-create en search met cursor-pagination.
  • Projects en initiatives: Beheer projecten, project-updates, milestones, project-relations, initiatives en roadmaps voor strategische planning over teams heen.
  • Customer requests: Koppel klantfeedback aan issues via customers, customer-needs, customer-statuses en customer-tiers en sync klantdata met je CRM of support-tool.
  • Releases en pipelines: Plan en track releases met release-stages, release-pipelines en release-notes en koppel issues aan releases voor changelog-generatie.
  • Integrations en webhooks: Beheer 30+ ingebouwde integrations (GitHub, Slack, Figma, Sentry), eigen webhooks met retry-logica en agent-sessions voor AI-workflows.
API Quick Facts GraphQL
  • Authenticatie OAuth2, API Key
  • Methods GET (147)POST (337)
  • Rate limits Complexity-budget van ~1500 punten per request; OAuth-apps tot 1.200 requests/uur per gebruiker, personal API keys tot 1.500 requests/uur
  • Webhooks Beschikbaar
  • Sandbox Niet beschikbaar
  • Response format JSON
  • SDK's Node.js

Laatste ontwikkelingen bij de Linear API

Linear publiceerde in 2020 een eerste publieke GraphQL API als enige API-flavour, gericht op de behoefte aan diepe integratie met code-hosts en CI-tools. De API is sinds dan continu uitgebreid: project-milestones en roadmaps (2022), initiatives en project-updates (2023), customer-requests, customer-tiers en customer-statuses (2024), en agent-sessions, agent-activities, release-pipelines en triage-responsibilities (2025). Linear gebruikt geen URL- of header-versionering: nieuwe velden komen er bij, oude worden gemarkeerd met @deprecated en uiteindelijk verwijderd. Roadmaps zijn in 2024 gedeprecieerd ten gunste van initiatives. De officiele Node-SDK genereert types direct uit het schema.

API versies

Agent-sessions & release-pipelines Major release
1 september 2025

Agent-sessions en agent-activities voor AI-workflows, plus release-pipelines, release-stages en release-notes voor gestructureerde release-management.

Customer requests Major release
1 september 2024

Customers, customer-needs, customer-statuses en customer-tiers toegevoegd voor het koppelen van klantfeedback aan issues, met merge- en upsert-mutations.

Initiatives & deprecation roadmaps Major release
1 maart 2024

Initiatives geintroduceerd als opvolger van roadmaps. Initiative-updates, initiative-relations en initiative-to-project-koppelingen toegevoegd; roadmap-API gemarkeerd als deprecated.

Project-updates & milestones
1 april 2023

Project-updates en project-milestones toegevoegd inclusief reminders en project-relations voor afhankelijkheden tussen projecten.

Roadmaps
1 juni 2022

Roadmap-API geintroduceerd voor strategische planning over teams en projecten heen (later gedeprecieerd ten gunste van initiatives).

Publieke GraphQL API Major release
1 september 2020

Eerste publieke API-release als GraphQL endpoint /graphql met OAuth 2.0 en personal API keys. Officiele Node-SDK met getypte client beschikbaar op GitHub.