API Linear : issues, projets et cycles avec des agents IA
Linear dispose d'une API GraphQL publique, la même que celle utilisée par l'application elle-même. Les équipes produit et ingénierie s'en servent pour créer des issues, automatiser le tri et se relier au support et à la supervision. L'accès se fait par une clé d'API personnelle ou par OAuth.
Ce que propose l’API Linear
Issues
Créer, rechercher, mettre à jour, assigner et changer l'état des issues.
Projets et initiatives
Consulter et mettre à jour les projets et leurs jalons.
Cycles
Lire les cycles et l'avancement de chacun.
Commentaires et pièces jointes
Commenter et lier des liens aux issues.
Équipes et étiquettes
Consulter les équipes, les états et les labels.
Webhooks
Recevoir les événements des issues, des commentaires et des projets.
Comment accéder à l’API Linear
- Avec les identifiants de votre entrepriseClé d'API personnelle générée dans les paramètres de Linear, ou application OAuth 2.0 avec périmètres, y compris comme application-agent.
- L'API applique des limites selon la complexité des requêtes : l'agent ne demande que les champs nécessaires.
- Utilisez un utilisateur ou une application dédiés pour garder un audit lisible.
- Les changements en masse passent par une approbation.
Documentation officielle: developers.linear.app
Ce qu’un agent iTeam fait avec l’API Linear
Tri de la boîte d'entrée
L'agent lit les issues à trier, suggère équipe, priorité et étiquette, et marque les doublons.
Le retour client devient une issue
Les demandes du support sont regroupées et deviennent une issue avec les liens vers les conversations.
Résumé du cycle
En fin de cycle, l'agent écrit ce qui est entré, ce qui est sorti et ce qui reste.
Erreur en production consignée
Les alertes de supervision ouvrent une issue avec la stack trace et le contexte.
De l’identifiant à l’agent au travail, avec validation
Générer la clé ou l'application
Dans les paramètres de Linear, générez une clé d'API pour un utilisateur d'intégration ou enregistrez une application OAuth.
Garder l'accès et limiter ce que fait chaque agent
L'accès à Linear est enregistré dans le coffre-fort d'iTeam. Vous choisissez quels agents l'utilisent et ce qu'ils peuvent faire (créer une issue, commenter, changer l'état), avec un plafond de coût et la trace de chaque appel.
Lancer le pilote avec approbation
Pendant le pilote, créez une issue dans une équipe de test. L'équipe approuve les actions sensibles et suit l'historique des appels dans iTeam.
Équipes IA prêtes à l’emploi pour ce travail
Reporting de direction
Les chiffres des ventes, de la finance et des opérations sont rassemblés, vérifiés et commentés en clair avant votre réunion de direction.
Gestion des stocks
L'équipe suit les ventes et les stocks, prévoit les ruptures et prépare des propositions de commande que vous validez.
Achats et devis fournisseurs
Les demandes de prix partent aux fournisseurs, les devis sont comparés ligne par ligne et l'acheteur décide avec l'historique sous les yeux.
Logistique et livraisons
Les livraisons du jour sont organisées en tournées, les chauffeurs suivis sur WhatsApp et les clients prévenus avant de s'inquiéter.
Questions sur l’API Linear
L'API Linear est-elle gratuite ?
L'API est disponible dans tous les forfaits de Linear, avec des limites d'usage.
Faut-il programmer pour utiliser l'API Linear avec iTeam ?
Pas forcément. L'équipe de déploiement d'iTeam configure l'accès à Linear et les actions de chaque agent à partir de la documentation ; la DSI n'a qu'à délivrer l'identifiant et à vérifier les permissions.
Linear a-t-il un MCP ?
Oui, Linear propose un serveur MCP officiel. iTeam peut l'utiliser ou appeler l'API GraphQL, selon le cas.
