All platforms

Agents for Linear

Linear provides an opinionated GraphQL API and real-time data-change webhooks for engineering and product issue tracking. In business operations like customer feedback resolution, an AI agent monitors incoming customer feedback, queries Linear for matching issues by team, title, or label, and drafts a structured issue or investigation comment with reproduction evidence. The product or engineering lead retains authority to approve bug creation, assign priority, or close duplicate reports. The agent never autonomously closes active customer tickets or modifies sprint cycles without human sign-off.

2 related templates

When to use it

Engineering leads, product managers, and operations teams managing issue triage and customer feedback handoffs.

Example scenario

A customer submits a report that CSV exports fail when dates contain slashes. The agent searches Linear for existing export issues, identifies an open bug on the Web team with similar symptoms, and drafts an internal comment with the customer's reproduction steps rather than creating a duplicate ticket. The product lead approves adding the customer note and linking the report to the existing Linear issue.

Getting started

  • Generate a Linear personal API key or configure OAuth2 credentials in team settings
  • Identify target team identifiers and available issue workflow states via GraphQL query
  • Register a webhook for issue data-change events if bidirectional sync is required
  • Configure human approval rules before issues are published or state changes are applied

Common questions

Does Linear use a REST API or GraphQL?

Linear's public API is exclusively GraphQL, requiring structured queries and mutations over HTTPS rather than standard REST endpoints.

Can an AI agent automatically close or delete Linear issues?

While the GraphQL API provides issueUpdate and issueDelete mutations, safe operational governance requires human approval before closing active issues or deleting team records.

How are file attachments handled in Linear via API?

Linear supports issue attachments via dedicated GraphQL mutations and attachment objects, or URLs pointing to externally hosted customer files.

How these workflows use your software

Customer feedback resolution

Source records
Customer feedback report with error logs and reproduction details
Agent work
Search Linear issues by team and keyword to detect existing bugs vs novel defect
Result
Structured Linear issue draft or investigation comment linked to the feedback thread
Human decision
Product or triage lead approves new bug creation, severity, and sprint assignment

Platform documentation