Passer au contenu principal
POST
/
v3
/
organizations
/
{org_id}
/
sessions
Créer une session
curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "platform": "<string>",
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "structured_output_required": true,
  "structured_output_schema": {},
  "tags": [
    "<string>"
  ],
  "title": "<string>"
}
'
{
  "acus_consumed": 123,
  "created_at": 123,
  "org_id": "<string>",
  "pull_requests": [
    {
      "pr_state": "<string>",
      "pr_url": "<string>"
    }
  ],
  "session_id": "<string>",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_archived": false,
  "parent_session_id": "<string>",
  "playbook_id": "<string>",
  "service_user_id": "<string>",
  "structured_output": {},
  "subcategory": "<string>",
  "title": "<string>",
  "user_id": "<string>"
}

​
Autorisations

Nécessite un compte de service disposant de l’autorisation ManageOrgSessions au niveau de l’organisation.

​
Autorisations supplémentaires pour les fonctions avancées

FonctionnalitéAutorisation requise
create_as_user_idImpersonateOrgSessions

​
Mode Devin

Le paramètre devin_mode détermine le mode d’agent Devin utilisé pour la session :
ModeDescription
normalLe mode d’agent par défaut. Rapide et efficace pour la planification à long terme.
fast~2x plus rapide, 4x plus cher, même intelligence.
S’il n’est pas renseigné, la session utilise le mode par défaut de l’organisation. Le mode rapide est soumis aux mêmes restrictions de feature flag et d’aperçu de l’agent Enterprise que l’application web.

​
Usurpation d’identité d’un utilisateur

Le paramètre create_as_user_id permet de créer une session sur le compte d’un autre utilisateur. Cela nécessite :
  1. Le compte de service doit disposer de l’autorisation ImpersonateOrgSessions
  2. L’utilisateur cible doit être membre de l’organisation
  3. L’utilisateur cible doit disposer de l’autorisation UseDevinSessions

Autorisations

​
Authorization
string
header
requis

Identifiant de compte de service (préfixe : cog_)

Paramètres de chemin

​
org_id
string | null
requis

ID de l’organisation (préfixe : org-)

Exemple:

"org-abc123def456"

Paramètres de requête

​
devin_id
string | null

Corps

application/json
​
prompt
string
requis
​
attachment_urls
string<uri>[] | null
Required string length: 1 - 2083
​
bypass_approval
boolean | null
​
child_playbook_id
string | null
​
create_as_user_id
string | null
​
devin_mode
enum<string> | null

Remplace 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 et 'ultra' utilise Devin Ultra. Fast, Lite et Ultra sont soumis au même feature flag et aux mêmes restrictions d’aperçu de l’agent Enterprise que l’application web.

Options disponibles:
normal,
fast,
lite,
ultra
​
knowledge_ids
string[] | null
​
max_acu_limit
integer | null
​
platform
string | null

Applique une dérogation à la plateforme de VM pour la session (p. ex. 'windows'). Si elle est omise (ou définie sur 'inherit'), une session créée par un Devin parent hérite de la plateforme du parent ; sinon, la plateforme par défaut de l'organisation est utilisée. Toute valeur doit correspondre à une plateforme configurée pour votre organisation (sans distinction de casse) ; les valeurs non reconnues sont rejetées avec une erreur 400 dont le corps liste les libellés de plateforme disponibles pour l'organisation.

​
playbook_id
string | null
​
repos
string[] | null
​
secret_ids
string[] | null
​
session_links
string[] | null
​
session_secrets
SessionSecretInput · object[] | null
​
structured_output_required
boolean | null

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é.

​
structured_output_schema
Structured Output Schema · object

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).

​
tags
string[] | null
​
title
string | null

Réponse

Réponse réussie

​
acus_consumed
number
requis
​
created_at
integer
requis
​
org_id
string
requis
​
pull_requests
SessionPullRequest · object[]
requis
​
session_id
string
requis
​
status
enum<string>
requis
Options disponibles:
new,
claimed,
running,
exit,
error,
suspended,
resuming
​
tags
string[]
requis
​
updated_at
integer
requis
​
url
string
requis
​
category
enum<string> | null

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.

Options disponibles:
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,
refactoring_and_optimization,
research_and_exploration,
security,
unit_test_generation
​
child_session_ids
string[] | null
​
is_archived
boolean
défaut:false
​
origin
enum<string> | null

Origine depuis laquelle la session a été créée.

Options disponibles:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
​
parent_session_id
string | null
​
playbook_id
string | null
​
service_user_id
string | null
​
status_detail
enum<string> | null

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.

Options disponibles:
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
​
structured_output
Structured Output · object

Sortie structurée validée provenant de la session. Renseignée uniquement sur les endpoints GET/list.

​
subcategory
string | null

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.

​
title
string | null
​
user_id
string | null