> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Notes de version des API
> Suivez les changements, les nouvelles fonctionnalités et les améliorations des API de Devin
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](/fr/release-notes/overview).
## 2026
**Mises à jour de l'API v3**
* **Endpoint d’ajout d’IP à la liste d’accès IP** : ajout de `POST /v3/enterprise/ip-access-list` pour ajouter des plages d’IP à la liste d’accès IP Enterprise sans remplacer les entrées existantes. Contrairement à `PUT /v3/enterprise/ip-access-list` (qui remplace l’intégralité de la liste), cet endpoint fusionne les plages fournies avec la liste actuelle. Nécessite l’autorisation `ManageEnterpriseSettings`.
* **Endpoint de mise à jour des autorisations Git** : ajout de `PATCH /v3/enterprise/organizations/{org_id}/git-providers/permissions/{git_permission_id}` pour mettre à jour une autorisation Git existante (par ex. en activant ou désactivant `read_only`). Nécessite l’autorisation `ManageGitIntegrations`.
* **Endpoints de lecture des membres à portée organisation (bêta)** : ajout de `GET /v3beta1/organizations/{org_id}/members/users`, `GET /v3beta1/organizations/{org_id}/members/users/{user_id}` et `GET /v3beta1/organizations/{org_id}/members/idp-users` pour lister et récupérer les membres d’une organisation à l’aide d’un utilisateur de service à portée organisation. Prend en charge la pagination par curseur (`after`, `first`) et le filtrage par `email`. Nécessite l’autorisation `ViewOrgMembership` au niveau de l’organisation.
* **Mode Devin Lite pour la création de session** : le paramètre `devin_mode` sur `POST /v3/organizations/{org_id}/sessions` accepte désormais également `"lite"` (Devin Lite), en plus de `"normal"` et `"fast"`. Les modes Fast et Lite sont soumis au même feature flag et aux mêmes restrictions d’aperçu de l’agent Enterprise que l’application web.
**Mises à jour de l'API v3**
* **Paramètre de mode Devin pour la création de session (21 mai)** : ajout du paramètre `devin_mode` à `POST /v3/organizations/{org_id}/sessions`. Accepte `"normal"` (mode Agent par défaut) ou `"fast"` (mode Fast). Lorsqu’il est omis, la session utilise le mode par défaut de l’organisation. Le mode Fast est soumis au même feature flag et aux mêmes restrictions d’aperçu de l’agent Enterprise que l’application web.
* **Endpoint des dépôts de connexion Git (18 mai)** : ajout de `GET /v3/enterprise/git-providers/connections/{connection_id}/repositories` pour lister les dépôts disponibles pour une connexion Git Enterprise spécifique. Prend en charge le filtrage par `filter_name` et la pagination par curseur (`after`, `first`). Nécessite l’autorisation `ManageGitIntegrations`.
**Mises à jour de l'API v3**
* **Endpoint de génération de Session Insights (11 mars)** : ajout des endpoints `POST /v3/organizations/{org_id}/sessions/{devin_id}/insights/generate` et `POST /v3/enterprise/sessions/{devin_id}/insights/generate` pour activer la génération des analyses de session à la demande. Renvoie `{ "status": "started" }` lorsque la génération démarre, ou `{ "status": "already_exists" }` si les analyses ont déjà été générées ou sont en cours de génération. Interrogez l’endpoint GET insights existant pour récupérer les résultats. Nécessite l’autorisation `ManageOrgSessions`.
**Mises à jour de l'API v3**
* **Endpoints v3 promus en prod** : les groupes d’endpoints suivants ont été promus de `v3beta1` à `v3` (prod). Mettez à jour vos URL de base de `/v3beta1/` vers `/v3/` pour ces endpoints :
* Sessions (création, liste, GET, messages, archivage, terminaison, tags, insights) — portées Enterprise et organisation
* Notes Knowledge — portées Enterprise et organisation
* Playbooks — portées Enterprise et organisation
* Secrets — portée organisation
* Plannings — portée organisation
* Pièces jointes — portée organisation
* Journaux d’audit — portées Enterprise et organisation
* Consommation et facturation (cycles, ventilations quotidiennes, limites d’ACU) — portée Enterprise
* Métriques (DAU, WAU, MAU, PRs, sessions, recherches, utilisateurs actifs, utilisation) — portée Enterprise
* Organisations, utilisateurs, membres, rôles, groupes IDP — portée Enterprise
* Connexions Git et autorisations — portée Enterprise
* Hyperviseurs, file d’attente, listes d’accès IP, limites de groupes d’organisation — portée Enterprise
* Tags de session (tags par défaut de l’organisation) — portée Enterprise
**Toujours en bêta** (`v3beta1`) : les endpoints d’indexation de dépôts, de provisioning d’utilisateurs de service et de violations de guardrails restent sur `v3beta1` et sont marqués d’une étiquette Beta dans la documentation.
* **Endpoint de violations de guardrails** : ajout des endpoints `GET /v3beta1/enterprise/guardrail-violations` et `GET /v3beta1/enterprise/organizations/{org_id}/guardrail-violations` pour interroger les violations de guardrails à l’échelle de l’Enterprise. Renvoie les détails de la violation, y compris le type de guardrail, le raisonnement, le score de confiance, l’action effectuée et le message déclencheur. Prend en charge le filtrage par `session_id` et `guardrail_id`, avec plage temporelle et pagination par curseur. Utilisez l’endpoint par organisation pour filtrer par organisation. Nécessite l’autorisation `ManageEnterpriseSettings`.
* **Endpoints de liste d'accès IP (9 fév.)** : ajout des endpoints `GET /v3beta1/enterprise/ip-access-list`,`PUT /v3beta1/enterprise/ip-access-list` et `DELETE /v3beta1/enterprise/ip-access-list` pour gérer les listes d’adresses IP autorisées pour Enterprise. L’endpoint PUT remplace l’intégralité de la liste par les plages d’IP fournies (notation CIDR prise en charge). Nécessite l’autorisation `ManageEnterpriseSettings`.
* **Endpoints de sessions planifiées (3 fév.)** : ajout d’endpoints de gestion des plannings au niveau de l'organisation : `POST /v3beta1/organizations/{org_id}/schedules` pour créer des plannings, `GET /v3beta1/organizations/{org_id}/schedules` pour lister les plannings, `GET /v3beta1/organizations/{org_id}/schedules/{schedule_id}` pour récupérer un planning spécifique, `PATCH /v3beta1/organizations/{org_id}/schedules/{schedule_id}` pour mettre à jour les plannings, et `DELETE /v3beta1/organizations/{org_id}/schedules/{schedule_id}` pour supprimer des plannings. Nécessite l’autorisation `ManageOrgSchedules`.
**Mises à jour de l'API v3**
* **Points de terminaison des limites d’ACU (27 janv.)** : Ajout de points de terminaison Enterprise pour la gestion des limites d’ACU des sessions Devin : `GET /v3beta1/enterprise/consumption/acu-limits/devin` pour consulter les limites, `PUT .../organizations/{org_id}` pour définir des limites au niveau de l’organisation et `DELETE` pour les supprimer. Nécessite l’autorisation `ManageBilling`.
* **Points de terminaison des pièces jointes (27 janv.)** : Ajout de points de terminaison de pièces jointes au niveau de l'organisation : `POST /v3beta1/organizations/{org_id}/attachments` pour téléverser des pièces jointes et `GET /v3beta1/organizations/{org_id}/attachments/{uuid}/{name}` pour télécharger des pièces jointes. Le téléversement nécessite la permission `UseDevinSessions`, le téléchargement nécessite la permission `ViewOrgSessions`.
* **Endpoint de file d’attente (21 janv.)** : Ajout de l’endpoint `GET /v3beta1/enterprise/queue` pour permettre aux administrateurs Enterprise de surveiller l’état de santé de la file d’attente des sessions. Renvoie le nombre total de sessions en file d’attente et un indicateur d’état (`normal`, `elevated` ou `high`). Utile pour configurer des alertes en cas de problèmes de capacité. Nécessite la permission `ViewAccountMetrics`.
* **Points de terminaison des sessions (19 janv.)** : Ajout des points de terminaison `GET /v3beta1/enterprise/sessions/{devin_id}` et `GET /v3beta1/organizations/{org_id}/sessions/{devin_id}` afin de récupérer les détails d'une session spécifique. Ajout des points de terminaison `POST /v3beta1/enterprise/sessions/{devin_id}/messages` et `POST /v3beta1/organizations/{org_id}/sessions/{devin_id}/messages` pour envoyer des messages aux sessions actives (les sessions sont automatiquement relancées si elles sont suspendues). Ajout également du paramètre de filtrage `origins` aux points de terminaison de liste de sessions pour filtrer par origine de session (`webapp`, `slack`, `teams`, `api`, `linear`, `jira`, `other`).
* **Paramètre d’ordre des journaux d’audit (17 janv.)** : Ajout du paramètre de requête `order` (`asc` ou `desc`, `desc` par défaut) aux endpoints des journaux d’audit Enterprise et d’organisation afin de contrôler l’ordre de tri des résultats.
* **Routeur de secrets (16 janv.)** : Ajout de points de terminaison de gestion des secrets au niveau de l'organisation : `GET /v3beta1/organizations/{org_id}/secrets` pour répertorier les secrets, `POST /v3beta1/organizations/{org_id}/secrets` pour créer des secrets, et `DELETE /v3beta1/organizations/{org_id}/secrets/{secret_id}` pour supprimer des secrets. Nécessite l'autorisation `ManageOrgSecrets`.
* **Correction des journaux d'audit (15 janv.)** : Correction d’un problème qui empêchait `end_cursor` d’être renvoyé dans les réponses de l’API des journaux d’audit lorsque la page contenait des éléments.
* **Provisionnement d’utilisateurs de service (14 janv.)** : Ajout des points de terminaison `POST /v3beta1/enterprise/service-users` et `POST /v3beta1/organizations/{org_id}/service-users` pour provisionner de nouveaux utilisateurs de service par programmation. Met en œuvre une prévention de l’escalade de privilèges : les autorisations du rôle cible doivent être un sous-ensemble des autorisations de l’appelant, et les autorisations `ManageServiceUsers` ne peuvent jamais être accordées. Nécessite respectivement l’autorisation `ManageAccountServiceUsers` ou `ManageOrgServiceUsers`.
* **Points de terminaison des groupes IDP au niveau Enterprise (14 janv.)** : Ajout de `GET /v3beta1/enterprise/idp-groups` pour répertorier les groupes IDP enregistrés au niveau Enterprise, de `POST /v3beta1/enterprise/idp-groups` pour l’enregistrement par lots de groupes IDP (jusqu’à 100 à la fois), et de `DELETE /v3beta1/enterprise/idp-groups/{idp_group_name}` pour supprimer un groupe IDP enregistré. Les groupes avec des affectations de rôles existantes ou des adhésions d’utilisateurs ne peuvent pas être supprimés. Nécessite l’autorisation `ManageAccountMembership`.
* **Actions du journal d'audit (12 janv.)** : Ajout des types d’actions `create_join_request`, `automatic_join_event` et `reject_join_request` dans les réponses du journal d'audit.
* **Point de terminaison des utilisateurs actifs (8 janv.)** : Ajout du point de terminaison `GET /v3beta1/enterprise/metrics/active-users` pour récupérer le nombre d’utilisateurs actifs uniques sur une plage de dates personnalisée. Contrairement aux points de terminaison DAU/WAU/MAU, qui renvoient des listes ventilées par période, ce point de terminaison renvoie un seul nombre d’utilisateurs actifs uniques sur l’ensemble de la plage spécifiée. Prend en charge le filtrage par ID d’organisation et par seuils d’activité configurables (`min_sessions`, `min_searches`).
* **Statut par défaut des hyperviseurs (8 janv.)** : L’endpoint `GET /v3beta1/enterprise/hypervisors` filtre désormais par défaut sur le statut `available` au lieu de renvoyer tous les hyperviseurs. Passez `status=all` pour obtenir les hyperviseurs, quel que soit leur statut.
* **Secrets de session (5 janv.)** : Ajout du paramètre `session_secrets` au point de terminaison de création de session (`POST /v3beta1/organizations/{org_id}/sessions`). Les secrets de session sont des secrets temporaires, disponibles uniquement pendant la session en cours et ne sont pas stockés parmi les secrets de l'organisation.
* **Correction de la pagination (5 janv.)** : Correction d’un problème de pagination dans l’API Enterprise Users v3 où `end_cursor` n’était pas toujours retourné correctement.
**Mises à jour de l'API v2**
* **Correctif pour le clonage de dépôts (20 janv.)** : Correction du schéma de l’endpoint `POST /v2/enterprise/organizations/{org_id}/clone-repository`. Suppression de l’ancien format `RepoSetupStepsT` et simplification du corps de la requête pour utiliser des champs simples (`pull_repo_commands`, `run_lint_commands`, `run_project_commands`, `update_dependencies_commands`, `repo_note`, `repo_path`).
* **Champs d’URL pour les autorisations Git (15 janv.)** : Ajout des champs `group_prefix_url` et `repo_url` au schéma `GitPermissionRequest`, fournissant des alternatives basées sur des URL complètes à la correspondance par chemin pour les dépôts et les préfixes de groupes.
* **Champ de rôle des membres de l'organisation (8 janv.)** : Ajout du champ `org_role_name` dans la réponse de `GET /v2/enterprise/organizations/{org_id}/members`, indiquant le rôle de chaque membre au sein de l'organisation.
* **Option de création d’organisation (8 janv.)** : Ajout du paramètre booléen `add_creator_as_member` (avec pour valeur par défaut `true`) à `POST /v2/enterprise/organizations`, permettant aux administrateurs Enterprise de créer des organisations sans être automatiquement ajoutés en tant que membres.
* **Documentation sur le fuseau horaire de consommation (7 janv.)** : Ajout d’une documentation décrivant le comportement lié au fuseau horaire pour les endpoints de consommation quotidienne. Les cycles de facturation utilisent minuit, heure du Pacifique (08:00:00 UTC), comme limite de journée.
**Mises à jour de l'API v1**
* **Mise à jour des types de secrets (16 janv.)** : Ajout de `dictionary` comme valeur de type de secret reconnue dans le schéma de l’API des secrets. Remarque : la création de secrets avec le type `dictionary` est désormais déconseillée ; utilisez plutôt `cookie`, `key-value` ou `totp`.
## 2025
**Mises à jour de l'API v3**
* **Endpoint des limites de groupes d’organisation (23 déc.)** : Ajout des endpoints `GET /v3beta1/enterprise/org-group-limits` et `PUT /v3beta1/enterprise/org-group-limits` pour gérer les configurations de groupes d'organisation. Les groupes associent des ensembles d'ID d'organisation à des limites maximales optionnelles d'Agent Compute Unit par cycle de facturation. Nécessite l'autorisation `ManageOrganizations`. *Cette fonctionnalité doit être activée par votre équipe de compte.*
* **Endpoint d'archivage de session (11 déc.)** : Ajout du endpoint `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 endpoint de liste des sessions (`GET /v3beta1/organizations/{org_id}/sessions`). Les clients doivent arrêter d'envoyer `order` ; utilisez à la place la pagination par curseur avec les paramètres `first`/`after`.
* **Routeur Searches (10 déc.)** : Ajout de endpoints 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`.
* **Prise en charge des sessions avancées (8 déc.)** : Ajout de nouveaux paramètres de requête pour les workflows de session avancée : `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 de tags de session (5 déc.)** : Ajout de endpoints 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.
* **Endpoint 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 endpoints `PUT` et `DELETE` pour remplacer en masse ou effacer toutes les autorisations d'une organisation.
* **Impersonation de session (5 déc.)** : Ajout du paramètre `create_as_user_id` au endpoint 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 endpoint des hyperviseurs renvoie désormais `utilization_percentage` au lieu de `max_slots` et `available_slots`.
* **Routeurs Notes et Playbooks (1er déc.)** : Ajout de endpoints de gestion des Notes et Playbooks au niveau Enterprise et au niveau organisation dans l'API v3. Les endpoints Notes nécessitent l'autorisation `ManageAccountKnowledge`, ceux de Playbooks nécessitent l'autorisation `ManageAccountPlaybooks`.
**Mises à jour de l'API v2**
* **Endpoint des limites de groupes d’organisation (23 déc.)** : Ajout des endpoints `GET /v2/enterprise/org-group-limits` et `PUT /v2/enterprise/org-group-limits` pour gérer les configurations de groupes d'organisation. Les groupes associent des ensembles d'ID d'organisation à des limites maximales optionnelles d'Agent Compute Unit par cycle de facturation. Le endpoint PUT remplace l'intégralité de la configuration (les groupes non présents dans la requête sont supprimés). *Cette fonctionnalité doit être activée par votre équipe de compte.*
* **Endpoint Self (23 déc.)** : Ajout du endpoint `GET /v2/enterprise/self` qui renvoie des informations sur l'API key authentifiée, y compris l'ID de la clé, l'ID de l'utilisateur associé, l'email de l'utilisateur et l'ID de l'organisation.
* **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 endpoints 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 endpoint `/v1/audit-logs` est obsolète ; utilisez à la place les endpoints de journaux d'audit v2 ou v3.
**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.
**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.
**Mises à jour de l'API Enterprise v2**
* **Routeur Roles (25 sept.)** : Ajout d'un routeur Roles 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 à l'API 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.
**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
**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** : Version héritée — sera prochainement abandonnée au profit de l’API Organization (v3)
* **v2** : Version héritée — sera prochainement abandonnée au profit de l’API Enterprise (v3)
* **v3** : Généralement disponible, recommandée pour toutes les nouvelles intégrations
***
## Migration vers l'API actuelle
Pour obtenir des instructions de migration détaillées étape par étape depuis v1 ou v2, consultez le [guide de migration](/fr/api-reference/getting-started/migration-guide).
## Support
Pour toute question relative aux modifications de l’API ou à l’assistance à la migration, envoyez un e-mail à [support@cognition.ai](mailto:support@cognition.ai).