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.