API do Linear: issues, projetos e ciclos com agentes de IA
O Linear tem uma API GraphQL pública que é a mesma usada pelo próprio app. Times de produto e engenharia usam para criar issues, automatizar triagem e integrar com suporte e monitoramento. O acesso é por chave de API pessoal ou OAuth.
Os grandes recursos da API, em português claro.
Criar, buscar, atualizar, atribuir e mudar estado de issues.
Consultar e atualizar projetos e seus marcos.
Ler ciclos e o progresso de cada um.
Comentar e vincular links a issues.
Consultar times, estados e labels.
Receber eventos de issues, comentários e projetos.
Como se acessa a API do Linear.
- Com credencial da sua empresaChave de API pessoal gerada nas configurações do Linear ou app OAuth 2.0 com escopos, inclusive como app-agente.
- Documentação oficialdevelopers.linear.app
- A API tem limites por complexidade de consulta; o agente busca só os campos necessários.
- Use usuário ou app dedicado para clareza na auditoria.
- Mudanças em massa com aprovação.
- api linear
- linear api graphql
- linear api documentação
- linear webhook
- integração linear
- linear api criar issue
O que um agente do iTeam faz com a API do Linear.
O agente lê issues em triagem, sugere time, prioridade e etiqueta e marca duplicadas.
Pedidos do suporte são agrupados e viram issue com links para as conversas.
No fim do ciclo, o agente escreve o que entrou, o que saiu e o que ficou.
Alertas de monitoramento abrem issue com stack trace e contexto.
Da credencial ao agente trabalhando, com aprovação.
Gerar a chave ou o app
Nas configurações do Linear, gere uma chave de API para um usuário de integração ou registre um app OAuth.
Guardar o acesso e limitar o que cada agente faz
O acesso ao Linear é cadastrado no cofre do iTeam. Você escolhe quais agentes usam e o que podem fazer (criar issue, comentar, mudar estado), com teto de custo e registro de cada chamada.
Rodar o piloto com aprovação
No piloto, crie uma issue em um time de teste. O time aprova as ações sensíveis e acompanha o histórico de chamadas no iTeam.
Dúvidas sobre a API do Linear.
A API do Linear é gratuita?
A API está disponível em todos os planos do Linear, com limites de uso.
Preciso programar para usar a API do Linear com o iTeam?
Não obrigatoriamente. O time de implantação do iTeam configura o acesso ao Linear e as ações de cada agente a partir da documentação; o TI só libera a credencial e revisa as permissões.
O Linear tem MCP?
Sim, o Linear oferece servidor MCP oficial. O iTeam pode usá-lo ou chamar a API GraphQL, conforme o caso.
A API do Linear é GraphQL e como autenticar nela?
A API do Linear é GraphQL, a mesma usada pelo próprio app, e aceita chave de API pessoal ou OAuth 2.0 com escopos. A chave pessoal é gerada nas configurações e serve para testes e automações simples. Para um agente em produção, a documentação também prevê app OAuth com autorização como agente, o que deixa claro quem fez cada alteração.
O que um agente de IA consegue fazer no Linear?
Pelo GraphQL ele cria e atualiza issues, comenta, aplica etiquetas, move itens entre ciclos e consulta projetos e iniciativas. Na triagem, por exemplo, lê um relato de suporte, procura duplicatas e abre a issue já no time certo. Priorizar o que entra no ciclo é decisão de produto e deve continuar com o responsável.
O Linear tem um ambiente de teste para a gente experimentar o agente?
A documentação consultada não menciona sandbox, então confira na documentação oficial se há workspace de teste para o seu plano. Uma alternativa prática é usar um time separado e vazio, com um app ou usuário dedicado ao agente, e conferir issues criadas antes de apontar para o time real. Assim a auditoria também fica limpa.
Como o limite de complexidade das consultas do Linear afeta um agente?
O Linear tem uma página de rate limiting para a API GraphQL, e a complexidade da consulta conta, por isso pedir campos demais ou listas grandes de uma vez custa mais. O desenho correto é o agente buscar só os campos de que precisa e paginar. Os valores exatos, confira na documentação oficial, pois não vou citar números sem fonte.
É preciso programar para integrar o Linear a um agente?
Para o básico, como criar issue a partir de uma mensagem, um engenheiro configura a chamada em pouco esforço, e há SDK em TypeScript. O que exige mais cuidado é decidir regras de triagem, quais etiquetas usar e quando abrir issue nova. No iTeam, a plataforma conecta a API e o time de implantação ajuda a montar essas regras com o seu time.
Webhooks do Linear servem para quê com um agente?
Os webhooks avisam quando uma issue é criada ou muda, e assim o agente reage na hora em vez de ficar consultando a API. É o gatilho ideal para triagem: nasceu uma issue, o agente classifica e sugere responsável. Valide a origem de cada chamada recebida e guarde o segredo do webhook em cofre, não no texto do agente.
Linear ou Jira: para qual dos dois um agente de IA é mais fácil de plugar?
Os dois têm API e dão conta, mas o Linear oferece uma API GraphQL consistente e uma seção de documentação dedicada a agentes de IA. Ferramentas muito customizadas, com muitos campos e fluxos, exigem mais mapeamento em qualquer uma. A escolha do sistema deve seguir o que o seu time usa, e não a facilidade de integrar.
Mudanças em massa no Linear por um agente são seguras?
Só com controle: alterar dezenas de issues de uma vez pode bagunçar ciclos e prioridades de um time inteiro. A prática segura é o agente listar o que pretende mudar, uma pessoa aprovar e a ação ficar registrada em um usuário ou app dedicado. No iTeam, a trilha de auditoria mostra quem pediu, o que o agente fez e quanto custou.
