Skip to main content
GET
Récupérer les analyses de 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 nécessaire que pour lire les sessions que l’utilisateur de service n’a pas créées et pour 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

Détails de session complétés par des métriques quantitatives et une analyse par IA.

Étend SessionResponse avec des champs supplémentaires qui nécessitent des requêtes supplémentaires.

acus_consumed
number
requis
created_at
integer
requis
num_devin_messages
integer
requis

Nombre de messages Devin envoyés pendant la session.

num_user_messages
integer
requis

Nombre de messages utilisateur envoyés pendant la session.

org_id
string
requis
pull_requests
SessionPullRequest · object[]
requis
session_id
string
requis
session_size
enum<string>
requis

Catégorisation de la taille de la session, basée sur l’utilisation d’ACU et le nombre de messages.

Options disponibles:
xs,
s,
m,
l,
xl
status
enum<string>
requis
Options disponibles:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
requis
updated_at
integer
requis
url
string
requis
analysis
SessionInsightsAnalysis · object | null

Analyse de session générée par l’IA. Aucune si l’analyse n’est pas terminée.

analysis_status
enum<string> | null

État de la dernière exécution de l’analyse de la session : 'completed', 'started' (en cours) ou 'failed'. None si l’analyse n’a jamais été exécutée. 'failed' permet de distinguer une exécution ayant échoué d’une analyse qui n’a jamais été exécutée ; analysis peut encore contenir le résultat d’une exécution antérieure terminée.

Options disponibles:
started,
completed,
failed
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 de profil de sécurité propre à la session. Renseignée uniquement via 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 de la session. Renseignée uniquement pour les points de terminaison 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