Skip to main content
GET
Récupérer une session (GET)
Le devin_id est l’identifiant de session préfixé par devin- (par exemple, devin-abc123).

Autorisations

Nécessite un utilisateur de service ou un jeton d’accès personnel appartenant à l’organisation et autorisé à consulter la session cible. L’appelant peut consulter une session si l’une des conditions suivantes est remplie :
  • Il a créé la session.
  • Il dispose d’un octroi session.view sur la session.
  • Il dispose de l’autorisation ViewOrgSessions au niveau de l’organisation.
ViewOrgSessions n’est requise que pour lire les sessions que l’utilisateur de service n’a pas créées et sur lesquelles il ne dispose d’aucun octroi session.view.

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"

devin_id
string | null
requis

ID de session Devin (préfixe : devin-)

Exemple:

"devin-abc123def456"

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
automation_id
string | null

ID de l’automatisation ayant créé cette session, le cas échéant.

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,
production_investigation,
refactoring_and_optimization,
research_and_exploration,
security,
unit_test_generation
child_session_ids
string[] | null
devin_mode
enum<string> | null

Le mode agent Devin avec lequel la session a été créée, après résolution des valeurs par défaut de l’organisation/de l’utilisateur et de l’héritage de la session parente. None lorsque la session exécute un aperçu d’agent qui n’a pas d’équivalent de mode.

Options disponibles:
normal,
fast,
fusion,
lite,
ultra,
swe-2-medium,
swe-2-high,
swe-2-max
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
security_profile
SessionSecurityProfileResponse · object | null

L’association au profil de sécurité propre à la session. Renseignée uniquement sur les endpoints get/list.

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', 'user_usage_limit_exceeded', 'total_session_limit_exceeded', 'contract_expired' 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,
user_usage_limit_exceeded,
total_session_limit_exceeded,
contract_expired,
error
structured_output
Structured Output · object | null

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