Passer au contenu principal
Cette page répertorie les modifications spécifiques aux API de Devin (v1, v2 et v3). Pour les mises à jour des fonctionnalités de l’application, consultez les notes de version de l’application.

​
2025

​
Décembre 2025
Mises à jour de l’API v3
  • Point de terminaison d’archivage de session (11 déc.) : Ajout du point de terminaison POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/archive pour archiver les sessions. Ajout également du paramètre de requête archive à DELETE /v3beta1/organizations/{org_id}/sessions/{devin_id} (terminer une session) et du champ is_archived dans les réponses de session.
  • Suppression du paramètre order (11 déc.) : Changement rétro-incompatible : suppression du paramètre de requête order du point de terminaison de liste des sessions (GET /v3beta1/organizations/{org_id}/sessions). Les clients doivent arrêter d’envoyer order ; utilisez à la place la pagination basée sur des curseurs avec les paramètres first/after.
  • Prise en charge des sessions avancées (8 déc.) : Ajout de la prise en charge des modes de session avancés (analyze, create, improve, batch, manage) avec de nouveaux paramètres de requête : advanced_mode, child_playbook_id, session_links et bypass_approval. Les réponses de session incluent désormais les champs child_session_ids, parent_session_id et is_advanced.
  • Routeur Searches (10 déc.) : Ajout de points de terminaison de recherche au niveau Enterprise et au niveau organisation à GET /v3beta1/enterprise/searches et GET /v3beta1/organizations/{org_id}/searches pour lister les recherches avec pagination et filtrage.
  • Améliorations des journaux d’audit (10 déc.) : Ajout des champs data (objet), service_user_name et user_email aux réponses des journaux d’audit. Ajout du type d’action update_git_permission.
  • Routeur de tags de session (5 déc.) : Ajout de points de terminaison CRUD sur /v3/beta/enterprise/organizations/{org_id}/tags pour gérer les tags de session autorisés par organisation. Lorsque la validation des tags est activée, la création de sessions et la mise à jour des tags imposent l’utilisation de tags figurant dans la liste autorisée.
  • Point de terminaison des sessions Enterprise (5 déc.) : Ajout de GET /v3/beta/enterprise/sessions pour lister les sessions à l’échelle de l’Enterprise avec un filtrage optionnel par org_ids.
  • Mises à jour Git Permissions (5 déc.) : Ajout du champ prefix_path pour faire correspondre les dépôts par préfixe de chemin. Ajout de points de terminaison PUT et DELETE pour remplacer en masse ou effacer toutes les permissions d’une organisation.
  • Impersonation de session (5 déc.) : Ajout du paramètre create_as_user_id au point de terminaison de création de session, permettant aux utilisateurs de service de créer des sessions pour le compte d’autres utilisateurs.
  • Changement de la réponse des hyperviseurs (5 déc.) : La réponse du point de terminaison des hyperviseurs renvoie désormais utilization_percentage au lieu de max_slots et available_slots.
  • Routeurs Notes et Playbooks (1er déc.) : Ajout de points de terminaison de gestion des Notes et Playbooks au niveau Enterprise et au niveau organisation dans l’API v3. Les points de terminaison Notes nécessitent la permission ManageAccountKnowledge, ceux de Playbooks nécessitent la permission ManageAccountPlaybooks.
Mises à jour de l’API v2
  • Champ messages des sessions (11 déc.) : Ajout du champ messages à la réponse de l’API de sessions v2, fournissant tous les messages de la session, similaire à l’API v1.
  • Améliorations des schémas de réponse (11 déc.) : Ajout de schémas de réponse appropriés pour les points de terminaison des journaux d’audit, des snapshots et des playbooks, y compris AuditLogsResponse, EnterpriseSnapshotResponse et EnterprisePlaybookResponse.
Mises à jour de l’API v1
  • Retrait des journaux d’audit (5 déc.) : Le point de terminaison /v1/audit-logs est obsolète ; utilisez à la place les points de terminaison de journaux d’audit v2 ou v3.
​
Novembre 2025
Mises à jour de l’API Enterprise v2
  • Mise à jour de la limite de pagination (21 nov.) : Limite maximale de pagination réduite de 1000 à 200 éléments par requête pour de meilleures performances et une fiabilité accrue. La limite par défaut reste de 100. Ce changement n’affecte PAS l’API externe v1.
  • Routeur Sessions (16 nov.) : Ajout de points de terminaison complets de gestion des sessions à l’API v2 pour les administrateurs Enterprise.
  • Point de terminaison Snapshots API (3 nov.) : Ajout d’un point de terminaison pour récupérer les détails des snapshots de manière programmatique.
Mises à jour de l’API v1
  • Point de terminaison de terminaison de session (31 oct.) : Ajout d’un point de terminaison pour arrêter les sessions en cours d’exécution de manière programmatique.
​
Octobre 2025
Lancement de l’API v3 (bêta)
  • Lancement de l’API v3 (23 oct.) : Lancement de l’API v3 avec prise en charge complète de RBAC, modèle d’authentification pour utilisateurs de service et journalisation d’audit complète pour les actions des utilisateurs de service.
Mises à jour de l’API Enterprise v2
  • Point de terminaison de création de snapshot (30 oct.) : Nouveau point de terminaison de l’API Enterprise Organizations v2 permettant aux administrateurs Enterprise de cloner des dépôts et de créer des snapshots de manière programmatique, avec des étapes de configuration personnalisées et des commandes de démarrage.
  • Améliorations de l’API Playbooks (14 oct.) : Ajout d’une API pour publier des playbooks Enterprise avec des fonctionnalités améliorées pour la gestion programmatique des playbooks.
​
Septembre 2025
Mises à jour de l’API Enterprise v2
  • Routeur Roles (25 sept.) : Ajout d’un routeur de rôles Enterprise avec cinq points de terminaison d’API pour gérer les rôles de manière programmatique.
Mises à jour de l’API v1
  • API Playbooks (6 sept.) : Ajout de points de terminaison complets de l’API Playbooks à v1 pour créer, mettre à jour, lister et supprimer des playbooks de manière programmatique.
  • Point de terminaison Secrets (5 sept.) : Ajout du nouveau point de terminaison POST /v1/secrets pour créer des secrets via l’API.
​
Mars 2025
Lancement de l’API Enterprise v2
  • Lancement de l’API v2 (23 mars) : Lancement de l’API Enterprise v2 pour les administrateurs Enterprise, avec des capacités de gestion des organisations, de suivi de la consommation et de gestion des membres.

​
2024

​
Octobre 2024
Lancement de l’API v1 (26 oct.)
  • Lancement de l’API REST pour la création et la gestion de sessions par programmation
  • Endpoints de création, de suivi et de gestion des sessions
  • Prise en charge du chargement et du téléchargement de fichiers joints
  • Authentification simple à l’aide d’API keys
  • Prise en charge de la création de sessions idempotente
  • Cas d’utilisation : revues automatiques de pull requests (PR), résolution d’erreurs de lint, migrations

​
Politique de gestion des versions de l’API

​
Rétrocompatibilité

Nous nous efforçons de maintenir la rétrocompatibilité au sein des versions majeures. Les modifications rompant la compatibilité seront :
  1. Annoncées au moins 7 jours à l’avance
  2. Documentées dans ces notes de version
  3. Accompagnées de guides de migration le cas échéant

​
Processus de dépréciation

Lorsque nous annonçons la dépréciation d’une fonctionnalité d’API :
  1. Annonce : Nous annonçons la dépréciation avec un échéancier
  2. Période de dépréciation : La fonctionnalité reste disponible mais est marquée comme dépréciée
  3. Suppression : La fonctionnalité est supprimée après la période de dépréciation

​
Prise en charge des versions

  • v1 : Généralement disponible et activement maintenue
  • v2 : Généralement disponible et activement maintenue
  • v3 : Bêta – susceptible d’évoluer, non encore recommandée pour un usage en production

​
Guides de migration

​
Migration de v1 vers v3

Si vous créez de nouvelles intégrations qui nécessitent des autorisations fines, envisagez d’utiliser v3 au lieu de v1 : Principales différences :
  • Authentification : v3 nécessite des jetons d’utilisateur de service au lieu de clés API personnelles/de service
  • Autorisation : v3 fournit un RBAC complet (contrôle d’accès basé sur les rôles)
  • Endpoints : v3 utilise des modèles d’URL différents (/v3beta1/* au lieu de /v1/*)
Étapes de migration :
  1. Créez un utilisateur de service dans Enterprise Settings > Service Users
  2. Attribuez les rôles appropriés à l’utilisateur de service
  3. Générez une API key pour l’utilisateur de service
  4. Mettez à jour votre intégration pour utiliser les endpoints v3
  5. Testez de manière approfondie dans un environnement hors production
Afficher la documentation de l’API v3 →

​
Migration de v2 vers v3

v3 offre plus de flexibilité que v2 pour l’automatisation au niveau Enterprise : Principales différences :
  • Authentification : v3 utilise des comptes de service au lieu d’exiger des clés personnelles d’administrateur Enterprise
  • Autorisation : v3 prend en charge un RBAC granulaire au lieu d’un accès réservé aux administrateurs Enterprise
  • Périmètre : v3 peut être limité à des organisations spécifiques, alors que v2 est toujours à l’échelle de l’Enterprise
Quand migrer :
  • Vous avez besoin d’automatisations ne nécessitant pas de droits d’administrateur
  • Vous souhaitez limiter l’accès à l’API à des organisations spécifiques
  • Vous avez besoin d’une séparation claire entre comptes utilisateurs et comptes de service
  • Vous exigez des journaux d’audit détaillés pour les actions automatisées

​
Support

Pour toute question concernant les modifications de l’API ou l’aide à la migration :