Créer une session
Créer une nouvelle session
Autorisations
ManageOrgSessions au niveau de l’organisation.
Autorisations supplémentaires pour les fonctions avancées
Mode Devin
devin_mode détermine le mode d’agent Devin utilisé pour la session :
Usurpation d’identité d’un utilisateur
create_as_user_id permet de créer une session sur le compte d’un autre utilisateur. Cela nécessite :
- Le compte de service doit disposer de l’autorisation
ImpersonateOrgSessions - L’utilisateur cible doit être membre de l’organisation
- L’utilisateur cible doit disposer de l’autorisation
UseDevinSessions
Autorisations
Identifiant de compte de service (préfixe : cog_)
Paramètres de chemin
ID de l’organisation (préfixe : org-)
"org-abc123def456"
Paramètres de requête
Corps
1 - 2083Redéfinit le mode Agent de Devin pour la session. 'normal' utilise le mode Agent par défaut, 'fast' utilise le mode Fast, 'lite' utilise Devin Lite, 'ultra' utilise Devin Ultra et 'fusion' utilise Fusion. Les modes Preview sont soumis aux mêmes restrictions de flag de fonctionnalité et d’aperçu de l’agent Enterprise que l’application web.
normal, fast, lite, ultra, fusion Dérogation à la plateforme VM pour la session (p. ex. 'windows'), ou nom d’un pool Outposts (BYOB) sur lequel exécuter la session sur l’une de vos propres machines. Lorsqu’elle est omise (ou définie sur 'inherit'), une session créée par un Devin parent hérite de l’emplacement du parent — à la fois de sa plateforme et de son pool Outposts ; ainsi, un parent placé sur un outpost lance des enfants sur le même pool ; sinon, la valeur par défaut de l’organisation est utilisée. Toute valeur doit correspondre soit à une plateforme configurée pour votre organisation, soit à un nom de pool Outposts (sans distinction de casse) — les plateformes intégrées sont prioritaires lorsqu’un nom correspond aux deux. Les valeurs non reconnues sont rejetées avec une erreur 400 dont le corps liste les libellés de plateforme disponibles et les noms de pool Outposts pour l’organisation.
Indique s’il faut conserver l’état de la VM de la session après son arrêt afin de pouvoir reprendre la session. Définissez cette valeur sur false pour les sessions temporaires.
Lorsque la valeur est true (par défaut), l’agent DOIT appeler provide_structured_output avec is_final=true avant la fin de son tour. Lorsque la valeur est false, l’outil est disponible mais non obligatoire — son appel n’est pas garanti pour un tour donné.
JSON Schema (Draft 7) pour la validation de la sortie structurée. Taille maximale : 64 Ko. Doit être autonome (aucune référence externe via $ref).
Réponse
Réponse réussie
new, claimed, running, exit, error, suspended, resuming Catégorie de cas d’usage attribuée à la session, si la catégorisation a été effectuée. Renseigné uniquement sur les endpoints get/list.
bug_fixing, ci_cd_and_devops, code_quality_and_security, code_review, code_review_and_analysis, data_and_automation, documentation_and_content, feature_development, migrations_and_upgrades, other, production_investigation, refactoring_and_optimization, research_and_exploration, security, unit_test_generation Origine depuis laquelle la session a été créée.
webapp, slack, teams, api, linear, jira, automation, cli, desktop, code_scan, other Informations supplémentaires sur le statut actuel de la session. Lorsque status vaut 'running' : 'working' (travaille activement), 'waiting_for_user' (nécessite une saisie de l’utilisateur), 'waiting_for_approval' (en attente d’approbation d’une action en mode sécurisé) ou 'finished' (tâche terminée). Lorsque status vaut 'suspended' : le motif de la suspension, par exemple 'inactivity', 'user_request', 'usage_limit_exceeded', 'out_of_credits', 'out_of_quota', 'no_quota_allocation', 'payment_declined', 'org_usage_limit_exceeded', 'total_session_limit_exceeded' ou 'error'. Renseigné uniquement sur les endpoints get/list.
working, waiting_for_user, waiting_for_approval, finished, inactivity, user_request, usage_limit_exceeded, out_of_credits, out_of_quota, no_quota_allocation, payment_declined, org_usage_limit_exceeded, total_session_limit_exceeded, error Sortie structurée validée provenant de la session. Renseignée uniquement sur les endpoints GET/list.
Nom d’affichage de la sous-catégorie attribuée à la session. 'Other' lorsqu’une catégorie est définie, mais qu’aucune sous-catégorie n’a été attribuée ou résolue. Renseigné uniquement sur les endpoints get/list.

