Linear API: issues, projects and cycles with AI agents
Linear has a public GraphQL API, the same one the app itself uses. Product and engineering teams use it to create issues, automate triage and connect with support and monitoring. Access is through a personal API key or OAuth.
What the Linear API offers
Issues
Create, search, update, assign and change the state of issues.
Projects and initiatives
Look up and update projects and their milestones.
Cycles
Read cycles and the progress of each one.
Comments and attachments
Comment and attach links to issues.
Teams and labels
Look up teams, states and labels.
Webhooks
Receive events for issues, comments and projects.
How to access the Linear API
- With your company’s credentialsA personal API key generated in the Linear settings, or an OAuth 2.0 app with scopes, including as an agent app.
- The API has limits based on query complexity, so the agent requests only the fields it needs.
- Use a dedicated user or app to keep the audit trail clear.
- Bulk changes need approval.
Official documentation: developers.linear.app
What an iTeam agent does with the Linear API
Inbox triage
The agent reads issues in triage, suggests team, priority and label, and flags duplicates.
Customer feedback becomes an issue
Support requests are grouped and become an issue with links to the conversations.
Cycle summary
At the end of the cycle, the agent writes what came in, what went out and what stayed.
Production error logged
Monitoring alerts open an issue with the stack trace and context.
From the credential to the agent at work, with approval
Generate the key or the app
In the Linear settings, generate an API key for an integration user or register an OAuth app.
Store the access and limit what each agent does
The Linear access is registered in the iTeam vault. You choose which agents use it and what they can do (create an issue, comment, change state), with a cost ceiling and a record of every call.
Run the pilot with approval
In the pilot, create an issue in a test team. The team approves sensitive actions and follows the call history in iTeam.
Ready-made AI teams for this work
Management reporting team
Revenue, margin, pipeline and cash in one report, built from your systems, with a short note on what changed and why.
Inventory planning team
Stock, sales and lead times are checked every day. You get a reorder list per SKU and a warning about what is not selling.
Procurement and quotes team
Requests go out to suppliers, quotes come back into one table, and the approver sees price, terms and past orders before saying yes.
Logistics and deliveries team
Routes, drivers and delivery status in one place, with customers told about delays before they have to ask.
Questions about the Linear API
Is the Linear API free?
The API is available on all Linear plans, with usage limits.
Do I need to write code to use the Linear API with iTeam?
Not necessarily. The iTeam deployment team sets up the Linear access and each agent's actions from the documentation; IT only releases the credential and reviews the permissions.
Does Linear have an MCP server?
Yes, Linear offers an official MCP server. iTeam can use it or call the GraphQL API, depending on the case.
