← All monitored APIs
Linear // api changelog

Linear API changelog

We check Linear's developer changelog every day, because we run production integrations on the Linear API. This page lists the 170 changes we have recorded since monitoring started on 28 March 2026, newest first.

In short

3 breaking changes and 0 deprecations in the Linear API in the last 90 days. The latest: “Removed emoji support in labels” (3 September 2026).

3 Breaking, 90 days
0 Deprecations, 90 days
170 Changes on record
Last checked

Linear API changes

Labels are assigned automatically. Check the vendor's note before planning work around an entry.

September 2026

  1. Callout components in documents

    New callout components with customizable colors, icons, and emojis can be used in issue and project descriptions and documents, with automatic conversion to GitHub callouts in PRs.

  2. Loops for product management - expanded triggers and capabilities

    Loops now respond to more workspace activity including initiatives, projects, and cycles changes; can edit Linear documents and post updates to Slack.

  3. MCP server visibility and team fields

    MCP's list_teams and get_team endpoints now report each team's visibility and retiredAt fields.

  4. New outbound webhook IPs for Linear

    New outbound IPs for webhooks will go live in the next few weeks with updated documentation.

  5. API

    startMode field added to SLA configuration: New startMode field and SLAStartMode enum added to SLA configuration responses for API consumers.

  6. API

    Outbound IP addresses published: Linear now publishes outbound IP addresses at a .well-known endpoint for firewall and security configuration.

  7. Document editing on mobile

    Document creation and editing now available on iOS and Android mobile apps.

  8. Draft projects with Linear Agent

    New project composer allows developing project ideas with Linear Agent before creating live projects, with automatic saving and context pulling.

  9. Priority inbox feature

    New Priority tab in inbox separates notifications that need attention from those that can wait, with customizable sources and filters.

  10. Removed emoji support in labels

    Labels can no longer contain emojis.

  11. Rich previews in diffs

    Images, fonts, Markdown, and PDFs now render directly inside Linear diffs; symlinks now supported.

  12. Third-party app approvals

    Admins on paid Linear plans can now review and approve third-party apps before installation.

August 2026

  1. Coding sessions

    environments, browser use, and updated pricing: Coding sessions now support configurable environments, browser testing, and transparent pricing model with model usage charged at provider rates and sandbox runtime at $0.25 per 20-minute block.

  2. Configurable coding environments

    Coding sessions now support configurable environments with pinned runtime versions, setup scripts, and environment variables for Python, Ruby, Go, and more.

  3. API

    subscribers field on Document: New subscribers field added to Document entity in GraphQL API.

  4. API

    subscription for user settings updates: New GraphQL subscription added to track user settings updates.

  5. Enterprise-managed authorization for MCP

    Linear's MCP now supports managing employee access through Okta-managed identity for Enterprise workspaces.

  6. Team initiatives

    Teams can now be assigned to lead initiatives, and private team-led initiatives are only visible to team members.

  7. Team initiatives

    Teams can now be assigned to lead initiatives, with support for private team-led initiatives visible only to team members.

July 2026

  1. API

    bodyData field in pull request comments: New bodyData field added to GraphQL pull request comments.

  2. API

    CycleCreate and CycleUpdate validation: CycleCreate and CycleUpdate now prevent overlapping schedules and validate neighboring cycles using dates.

  3. GitHub Copilot for Linear

    GitHub Copilot users can now assign issues directly to Copilot's cloud agent from Linear for automated work.

  4. GitHub teams support in reviews

    Can now assign reviews to GitHub teams with dedicated section in Reviews inbox.

  5. Guided Reviews general availability

    Guided Reviews now generally available for larger pull requests with bigger context window and better latency on Business and Enterprise plans.

  6. Signed commits for coding sessions

    Coding sessions now support SSH and GPG signed commits; admins can require signing key uploads.

  7. API

    bodyData in pull request comments: Added `bodyData` field to GraphQL pull request comments.

  8. API

    CycleCreate and CycleUpdate validation: `CycleCreate` and `CycleUpdate` now prevent overlapping schedules and validate neighboring cycles using their dates.

  9. Refreshed issue sidebar

    Issue sidebar now integrates properties with main content and pins Diffs to the top.

  10. Text attribution and agent-assisted editing

    Documents and project descriptions can now be edited with Linear Agent; author name indicators show if text was written by colleague or loop.

  11. Asks

    Resolved thread handling: Email intake threads and synced comment threads can now be resolved/unresolved, with replies reopening resolved threads.

  12. Introducing Loops

    New feature allowing Linear Agent to take on recurring work at team/workspace level, triggered by schedule or events, using AI credits (Business/Enterprise plans with promotional credits).

  13. Issues

    Issue description comments on iOS: Added inline issue description comments on iOS with highlights and tap-to-scroll functionality.

  14. Linear Agent now manages inbox notifications

    Linear Agent can now manage workspace inbox notifications as part of its capabilities.

  15. Loops - recurring agent workflows

    New Loops feature for recurring agent workflows triggered on schedule or events; available on Business and Enterprise plans with AI credits.

  16. Loops can send user notifications

    Loops now support sending user notifications as part of their automated workflows.

  17. MCP server improvements for attachment uploads

    Improved MCP attachment uploads to accept base64 payloads with whitespace or data: URL prefixes.

  18. API

    URL field in webhook payloads: Data-change webhook remove action payloads now include top-level URL field when entity URL is available.

  19. API

    Source URL support in save_customer_need: Added source URL support to the `save_customer_need` MCP tool.

  20. API

    External-user actor variant in webhooks: Webhook actor union now includes external-user actor variant for data-change and entity webhooks.

  21. Centrally manage access to Linear's MCP server in Claude

    Enterprise-Managed Authorization enables Okta administrators to centrally manage access to Linear MCP servers.

  22. Initiative properties

    Added new initiative properties including Proposed/Canceled statuses, Priority, and Labels for better initiative management and filtering.

  23. Initiative properties

    Added proposed/canceled statuses, priority, and labels to initiatives for better roadmap management.

  24. MCP

    Release management: Added support for managing releases, release notes, and release issue associations through MCP server.

  25. Share filtered views

    Can now share any filtered view by copying URL or using keyboard shortcut.

  26. Webhook external-user actor variant

    Added external-user actor variant to webhook actor union.

June 2026

  1. Agent assisted project updates

    Click Write with Agent to automatically generate project/initiative updates by reviewing recent changes and Slack messages.

  2. API

    templateCreate and templateUpdate validation: `templateCreate` and `templateUpdate` now reject unsupported form field payloads, requiring validation of template configurations.

  3. API

    Template validation: `templateCreate` and `templateUpdate` now reject unsupported form field payloads.

  4. Build agents with Vercel Eve

    Vercel Eve framework allows building custom agents that can be deployed and connected to Linear.

  5. Desktop navigation history and pinned tabs

    Desktop tabs now have individual history stacks; pinned tabs persist after app restart and aren't replaced by new content.

  6. MCP

    Source URL support for save_customer_need tool: The save_customer_need MCP tool now supports source URL configuration.

  7. OAuth application manifests

    OAuth application manifests enable one-click OAuth app setup through URL parameters or JSON configuration.

  8. Private sub-teams

    Sub-teams can now be private with two access options: restricted to parent team members or private to team members only.

  9. Release pipeline changelogs

    Release pipelines now support changelogs with auto-generation option to keep release notes aggregated.

  10. Vercel Eve agent framework integration

    Build custom agents using Vercel Eve open-source framework and deploy via Vercel or self-host.

  11. Agent automation for bug investigation and fixing

    Linear Agent can automatically investigate incoming issues and attempt fixes through agent automation before reaching engineers.

  12. Coding sessions in Linear

    Linear Agent can now write code using Claude Code and Codex, with cloud-based coding sessions and diff review capabilities.

  13. Coding sessions in Linear

    Linear Agent can now write code using Claude Code and Codex, with cloud-based sessions and diff review workflow.

  14. MCP documents listing and creation

    MCP server now supports listing and creating documents under teams.

  15. MCP list_comments returns archived issues

    MCP list_comments endpoint now returns comments on archived issues.

  16. Multi-level sub-teams

    Teams can now have multi-level hierarchies with nested sub-teams for more complex organizational structures.

  17. Issue description comments

    Users can now comment directly on specific text or images in issue descriptions with anchor points.

  18. MCP server

    Documents management under teams: MCP server now supports listing and creating documents under a team context.

  19. Shared skills for Linear Agent

    Skills can now be shared with teams, allowing personal workflows to become standardized team processes.

  20. Team documents

    Every team now has a dedicated page for organizing team-level context including documents, notes, and shared references.

  21. Team documents feature

    Every team now has a dedicated documents page for organizing shared notes, docs, and references with support for sections and pinning.

May 2026

  1. Guided reviews (beta)

    Added beta feature for efficient large PR review with AI-generated explanations separating core changes from glue code.

  2. Linear Diffs

    Native code review capability allowing users to review diffs from Linear with synchronized review state back to GitHub.

  3. Linear Diffs code review feature

    Released native code review feature for Linear with guided reviews (beta), review inbox, and real-time diff updates with agent changes.

  4. Copy pull request file action in Diffs

    Diffs file actions now include the ability to copy a link to a specific file.

  5. Diffs available on legacy plans

    Customers on legacy plans can now access and use the Linear Diffs feature.

  6. Guided reviews for large pull requests

    Guided reviews present core changes first with explanations, separating glue code to help reviewers focus on important changes.

  7. Linear Diffs

    Native code review in Linear: Linear now includes native code review with responsive diff viewing, split/unified modes, and real-time agent code updates.

  8. Missing issue PR filter in Diffs

    Diffs now includes a 'Missing issue' PR filter to show pull requests without a linked Linear issue.

  9. Open full file in GitHub from Diffs

    Diffs now provides a file action to open the full file in GitHub from the review interface.

  10. Paste GitHub PR link in command menu

    Users can now paste a GitHub pull request link into the command menu to open it in Linear.

  11. Reviews inbox and sidebar tab

    Review notifications now appear in the main inbox, with a dedicated Reviews tab in the sidebar for managing all review work.

  12. API

    Team.visibility field added: New Team.visibility field added to GraphQL API; Team.private is now deprecated.

  13. API

    OAuth token migration endpoint deprecated: Returns 410 Gone from /oauth/migrate_old_token; old OAuth token migration is no longer supported.

  14. API

    AgentSkill GraphQL types: Added parallel AgentSkill GraphQL query and mutation types alongside deprecated AiPrompt roots for skill migration.

  15. API

    Team.visibility field added: Added Team.visibility field and deprecated Team.private field.

  16. GitHub Enterprise Cloud integration

    Added support for GitHub Enterprise Cloud with PR linking, issue sync, and code review capabilities.

  17. Issue duplicates with dedicated status

    Duplicate issues now use dedicated status type with automatic context moving (customer requests, Slack threads, attachments) to original issue.

  18. Linear Asks Agent

    New Slack agent allowing anyone to file requests by mentioning @Linear Asks, with template matching and required field collection.

  19. Project Slack channels

    Linear can now automatically create and manage Slack channels for new projects with automatic member management.

  20. Reorder groups in issue and project views

    Added ability to reorder groups (status, priority, labels) in list and board views via display options.

  21. API

    Project slackChannelId and microsoftTeamsChannelId fields: GraphQL API adds slackChannelId and microsoftTeamsChannelId fields on Project to return connected chat channel IDs.

  22. API

    Release backdating support: Release inputs now accept createdAt, startedAt, and completedAt fields to support backdating releases.

  23. API

    SCIM user groups always populated: SCIM user payloads now always populate user groups, changing from previously inconsistent behavior.

  24. Code Intelligence

    Linear Agent can now access codebase via Code Intelligence to reason about implementations and answer technical questions.

  25. Code Intelligence for Linear Agent

    Linear Agent now has controlled access to codebases via Code Intelligence, available in public beta for Business/Enterprise plans.

  26. MCP

    Label parameter handling changes: save_project no longer accepts issue-level label IDs and label arrays sent as JSON strings are parsed instead of being silently dropped.

  27. MCP parameter validation

    MCP unknown tool parameters now return validation error instead of being silently dropped.

April 2026

  1. API

    Spelling consistency fix: Fixed inconsistent `cancelled` vs `canceled` spelling in integration field descriptions.

  2. Linear Agent can work with issue drafts

    Linear Agent now supports creating and editing issue drafts.

  3. MCP server

    Integration-aware attachment links: Links added through save_issue now use integration-aware attachmentLinkURL path, so URLs matching configured integrations create rich attachments and trigger two-way sync.

  4. MCP server zero-value serialization fix

    Issues with 0-point estimates or 'No priority' no longer serialize as undefined, allowing consumers to distinguish explicit zero from unset values.

  5. MCP URL attachment handling

    MCP server: URLs added through save_issue now go through integration-aware attachment path for rich attachments and two-way sync instead of plain URLs.

  6. Project Slack channels automation

    Slack integration now automatically creates connected channels for new projects and adds project members to those channels.

  7. Releases

    Linear Releases enables planning and tracking software releases with CI/CD integration, automatic status updates, and release notes generation.

  8. Releases feature

    Linear Releases integrates with CI/CD tools to track deployment environment, version, and status of every issue with automatic status updates and AI-generated release notes.

  9. API

    Webhook retry for agent delegation: Agent delegation webhooks are now retried after an initial failed delivery.

  10. Issue-level sharing controls

    Team owners can now configure who can share issues with non-members; sub-issues no longer inherit parent issue's share state.

  11. Linear Agent MCP support

    Linear Agent can now connect to tools via MCP servers like Granola, Glean, Notion, PostHog to access external data and actions.

  12. Select text to send to agent

    New capability to select text anywhere in Linear and press ⌘J to send it directly to the agent as context.

  13. API documentUpdate mutation fix

    Fixed documentUpdate mutation failing when called with a URL-style document identifier instead of a UUID.

  14. Custom coding tool integrations

    New support for custom coding tool integrations allowing users to configure tools not supported out-of-the-box via URL parameters or local commands.

  15. Linear for Microsoft Teams

    New Microsoft Teams integration allowing users to mention @Linear to create issues, get information from Linear, and receive project update notifications in Teams.

  16. MCP server OAuth connections stability fix

    Fixed issue where MCP OAuth connections could disconnect after approximately 1 day.

  17. Sync multiple Slack threads to an issue

    New feature allowing syncing of multiple Slack threads to a single Linear issue for multiple reports/requests of same issue.

  18. API

    Fixed workflow state position collisions: Fixed bug where workflow state positions were being unexpectedly reordered when resolving position collisions.

  19. MCP issue creation default state handling

    Issues created through MCP without a stateId now default to team's default state even when triage is enabled, if user is team member.

  20. Multi-level sub-teams

    New feature allowing teams to nest up to five levels deep (divisions, departments, groups, squads) with inherited workflows and settings.

  21. Project and initiative comments

    New feature adding comment support to project and initiative activity feeds for high-level discussion.

  22. Agent bulk update confirmation removed

    Linear Agent no longer asks for confirmation on routine bulk updates of up to 5 issues.

  23. Agent context expansion

    My Issues, Inbox, Reviews, Pulse, and team views can now be included as context for Linear Agent.

  24. Agent customer deletion capability

    Linear Agent now has the ability to delete customers.

  25. API

    Issue parentId filter for subscriptions: Added parentId filter to issue GraphQL subscriptions.

  26. MCP

    Issues default state handling: Issues created through MCP without stateId now default to team's default state even when triage is enabled.

  27. MCP server

    Removed issue relationships support: Added support for removing issue relationships through MCP server tools.

  28. Web forms for Linear Asks

    New feature allowing teams to create dedicated web forms for capturing requests (feature requests, bug reports, etc.) powered by issue templates.

March 2026

  1. API

    Template description validation: Added validation of template `descriptionData` against ProseMirror schema to reject invalid node types.

  2. Code Intelligence (coming soon)

    Announced upcoming Code Intelligence capability extending Linear Agent's understanding to codebases for code-aware tasks.

  3. GraphQL subscriptions now available in API

    GraphQL subscriptions are now available for use with the Linear API.

  4. Introducing Linear Agent

    Linear Agent is a new AI-powered assistant built into Linear that understands your roadmap, issues, and code to help synthesize context and take action.

  5. MCP multiple parent initiatives support

    Improved initiatives to return and accept multiple parent initiatives instead of a single parent in MCP server.

  6. MCP pagination support for list_comments

    Added cursor-based pagination support to the list_comments MCP tool with limit and orderBy parameters.

  7. Skills and Automations

    Users can save reusable Linear Agent workflows as skills and trigger agent workflows automatically when issues enter triage.

  8. Team.parent field added to API

    New Team.parent field added to the public GraphQL API for querying parent team relationships.

  9. Additional AI coding tool launchers

    Support expanded for opening issues in additional AI coding tools including Amp, Codex CLI, Devin, Factory, Lovable, Netlify Agent Runners, Warp, and Windsurf.

  10. API issue creation default state behavior

    Issues created through the API without stateId now default to team default state even when triage is enabled, if user is team member.

  11. Markdown file links rendering in mutations

    Previously uploaded file links now correctly render in the editor when used in mutations instead of appearing as plain links.

  12. Mobile agent sessions

    Linear mobile app now supports viewing real-time reasoning and past sessions from coding agents.

  13. Multiple parents for sub-initiatives

    Sub-initiatives can now belong to multiple parent initiatives, allowing flexible goal hierarchy representation.

  14. Send comment on Enter preference

    Added preference to choose between sending comments with Enter key or Cmd/Ctrl+Enter.

  15. UI refresh

    Comprehensive visual refresh of Linear's interface with consistent headers, navigation, resized icons, and dimmer sidebars.

February 2026

  1. API

    Markdown file links rendering: Previously uploaded file links now render correctly in the editor when used in mutations instead of appearing as plain links.

  2. Customizable coding tool prompt templates

    Users can customize prompt templates for how coding agents should approach issues using variables like {{issue.identifier}} and {{context}}.

  3. Deeplink to AI coding tools

    Users can now launch preferred coding tools directly from Linear issues with prefilled prompts containing issue context, including customizable prompt templates.

  4. Default template state now respected in issue creation

    Default template statuses are now respected when creating issues, fixing inconsistencies in state assignment.

  5. diffMarkdown field added to webhook payloads

    Added diffMarkdown field to project and initiative update webhook payloads providing formatted summary of changes.

  6. Linear in Notion's Custom Agents

    New integration enabling creation and updates of Linear issues and projects using Notion's Custom Agents.

  7. MCP create_issue and update_issue tools consolidated

    Combined create_issue and update_issue MCP tools into a single save_issue tool, breaking change for existing MCP implementations.

  8. Project webhook milestone and relation changes

    Project webhooks now trigger on milestone and relation changes in addition to existing events.

  9. Advanced filters

    Users can now combine multiple AND/OR conditions in filters to refine searches, views, and dashboards, with AI filter capability for natural language queries.

  10. Create projects and initiatives on mobile

    Projects and initiatives can now be created directly on Linear's Android and iOS mobile apps.

  11. CustomerNeed.url field removed

    The deprecated CustomerNeed.url field has been removed; use attachmentUrl field instead.

  12. Gemini Enterprise connector

    Gemini Enterprise users can now create issues from Gemini and access data from existing issues and projects.

  13. MCP project resources and members

    Added project resources to MCP responses and ability to list project members.

  14. Share issues from private teams

    Individual issues from private teams can now be shared with specific users outside the team without granting full team access (Enterprise only).

  15. YouTube and Loom video auto-embedding

    Videos from YouTube and Loom are now automatically converted to embeds when added as ![](link/to/video) in Markdown.

  16. API

    OAuth app agents delegation behavior: OAuth app agents no longer automatically become the delegated agent when updating an issue's status to Started or Done.

  17. API

    IssueHistory resolvers expansion: Added IssueHistory resolvers for project milestones, SLA changes, and triage responsibility teams.

  18. Deprecation of /sse MCP endpoint

    SSE transport has been deprecated in favor of HTTP streams; endpoint moving from https://mcp.linear.app/sse to https://mcp.linear.app/mcp with gradual rollout of deprecation errors over two months.

  19. Linear MCP for product management expansion

    MCP server expanded with support for initiatives, project milestones, updates, and improved performance with better tool documentation and URL resource loading.

  20. MCP create_issue and update_issue consolidation

    The create_issue and update_issue MCP tools have been combined into a single save_issue tool.

  21. MCP project members and resources

    Added ability to list project members and access project resources in MCP responses.

  22. MCP project slug lookup support

    Projects can now be looked up by slug in MCP responses.

  23. Nested sub-issues display

    Issue lists can now show sub-issues as a nested hierarchy as a display option.

  24. Retired teams

    Added ability to retire teams making them read-only and hidden from sidebar while preserving history.

January 2026

  1. Jira Epic sync

    Added bi-directional syncing between Jira Epics and Linear projects for status, target date, and description.

  2. MCP assignee and delegate null removal

    In update_issue and update_project MCP tools, assignee, delegate, and lead can now be set to null to remove them.

  3. Time in status tracking

    Added time in status tracking available as display option in views and as measure in Insights.

  4. AgentSession.type field deprecated

    The AgentSession.type field in the API is now deprecated and will be removed in the future.

  5. Customize Linear Mobile navigation

    Added ability to customize bottom toolbar on mobile app and pin projects, initiatives, and documents.

  6. Linear Agent for Slack on all plans

    Made Linear Agent for Slack available on every plan including Basic and Free.

  7. Linear Code Reviews (Private Beta)

    Announced Linear Code Reviews now in private beta, bringing code reviews directly into Linear with support for PR workflows and agent output.

  8. OAuth token revocation parameter changes

    Added RFC 7009-compliant token and token_type_hint parameters to /oauth/revoke endpoint; existing access_token and refresh_token parameters are deprecated but remain functional.

  9. Redesigned timing charts

    Redesigned timing charts in Insights and Dashboards with logarithmic scale, percentile metrics by slice, and removed issue limits.

December 2025

  1. Team owners role introduced

    New team owner role with team-level permissions for managing settings, labels, templates, and membership (Business and Enterprise plans).

Frequently asked questions

Has the Linear API had breaking changes recently?
Yes: 3 breaking changes and 0 deprecations in the last 90 days. The most recent is “Removed emoji support in labels” from 3 September 2026.
How often does the Linear API change?
Over the period on record, Linear published about 17 changelog entries a month. Most are additions; the breaking changes and deprecations are the ones to plan for.
Where is the official Linear API changelog?
Linear publishes it at https://linear.app/changelog. This page follows it daily and dates each entry.
How do I get notified about Linear API changes?
Subscribe to this page's RSS feed (https://seamless.engineering/api-changelog/linear/rss.xml). If you would rather have someone act on them, we operate Linear integrations and handle changes like these before they reach production.

Other APIs we monitor

// scoping request

We watch Linear because we run integrations on it. If one of yours depends on Linear, we can take it over: build it properly, operate it, and fix it when Linear changes, before your data is affected. Fixed-price scoping quote within 48 hours.

We reply within one working day. No newsletter, no sales sequence.