Passer au contenu principal
Cette page présente des workflows de bout en bout courants avec l’API Devin. Chaque workflow inclut la séquence complète des appels d’API, avec des exemples de code. Pour les détails de chaque endpoint, consultez les pages pertinentes de la référence d’API.

Configuration

Définissez ces variables d’environnement avant d’exécuter un exemple :

Premiers pas : de l’API key à la première session

Le workflow le plus courant — s’authentifier, récupérer les informations de votre compte et créer votre première session.

Étape 1 : Vérifiez vos identifiants

Les utilisateur de service limité au périmètre de l’organisation peuvent passer à l’Étape 3 — vous connaissez déjà l’ID de votre org sur la page Settings.
Réponse :

Étape 2 : Lister vos organisations

Les utilisateurs de service Enterprise peuvent lister toutes les organisations :
Les utilisateurs de service limités au périmètre de l’organisation connaissent déjà l’ID de leur org (cet ID figure en haut de la page Settings > API Devin, là où l’utilisateur de service a été provisionné).

Étape 3 : Créer une session

Réponse :

Étape 4 : Interroger périodiquement les événements

Surveillez la session en interrogeant périodiquement les messages :

Exemple complet en Python


Téléchargement des pièces jointes d’une session

Récupérez les fichiers produits par une session (journaux, captures d’écran, code généré, etc.).

Étape 1 : Récupérer la session

Étape 2 : Lister les pièces jointes

Réponse :

Étape 3 : Téléchargement

N’utilisez pas de clé d’API avec la valeur url. Cette URL nécessite une connexion à la webapp. Utilisez l’endpoint de téléchargement avec les valeurs attachment_id et name. L’endpoint renvoie une redirection 307 vers une URL de courte durée ; veillez donc à suivre les redirections :

Exemple complet en Python


Gestion de Knowledge et des playbooks

Gérez le contexte et les instructions que Devin utilise d’une session à l’autre.

Créer une note de Knowledge

Lister les notes de Knowledge

Mettre à jour une note de Knowledge

Supprimer une note de Knowledge

Créer un playbook

Les endpoints /playbooks sont obsolètes. Les playbooks migrent vers les Compétences. Dans un compte déjà migré, cette requête écrit le skill associé au playbook. Un compte créé à partir du 24 octobre 2026 et ne contenant aucun playbook reçoit une réponse 410 de ces endpoints. Consultez Les playbooks migrent vers les Compétences.

Exemple complet en Python


Planifier des sessions automatisées

Créez des sessions récurrentes à l’aide d’une automatisation dotée d’un trigger schedule:recurring. Ce trigger accepte une seule condition rrule : une RRULE iCalendar évaluée en UTC (par exemple FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=13;BYMINUTE=0 pour les jours ouvrés à 9 h, heure de l’Est, pendant l’heure d’été). Nécessite l’autorisation ManageOrgAutomations.
Les anciens endpoints /schedules sont dépréciés. À compter du 24 septembre 2026, POST /v3/organizations/{org_id}/schedules renverra 403 pour les organisations migrées vers les automatisations. Consultez les notes de version de l’API.

Créer une automatisation planifiée

Pour une exécution ponctuelle, utilisez un DTSTART avec COUNT=1, par exemple DTSTART:20260915T170000Z\nRRULE:FREQ=DAILY;COUNT=1. L’automatisation se déclenche une seule fois, puis se désactive automatiquement.

Lister, mettre à jour et supprimer

Exemple complet en Python


Passer le relais pour une tâche depuis n’importe où

Comme l’API Sessions crée une session cloud de Devin à partir d’une seule requête, n’importe quel outil, script ou agent de développement peut « passer le relais » du travail à Devin en regroupant le dépôt actuel, la branche et les modifications non commitées dans le prompt, afin que la session cloud reprenne là où vous vous êtes arrêté.

Créer une session avec le contexte du dépôt

La session cloud clone le dépôt, applique le contexte de votre prompt et s’exécute dans sa propre VM avec un Shell, un Browser et un accès complet au dépôt. Suivez-la en interrogeant périodiquement les messages ou dans l’application web Devin.
git diff HEAD peut inclure des secrets non commités — des clés d’API, des tokens ou des modifications de .env — et le prompt est envoyé à la session cloud. Vérifiez votre diff, puis effectuez un commit, un stash ou supprimez les modifications sensibles avant de passer le relais.
Vous ne voulez pas mettre cela en place vous-même ? Exportez une clé d’API Devin dans la variable DEVIN_API_KEY de votre shell, puis demandez à votre agent de programmation de créer une session Devin à partir de ce flux. Consultez Passer le relais à Devin.

Gestion des erreurs

Tous les exemples ci-dessus doivent inclure une gestion des erreurs en environnement de production. Voici un modèle réutilisable :

Assistance

Besoin d’aide ?

Pour toute question concernant l’API ou pour signaler des problèmes, envoyez un e-mail à support@cognition.ai