Saltar al contenido principal
DELETE
Finalizar sesión
El devin_id es el ID de la sesión con el prefijo devin- (por ejemplo, devin-abc123).

Permisos

Requiere un usuario de servicio o un token de acceso personal que pertenezca a la organización y pueda gestionar la sesión de destino. El autor de la llamada puede gestionar una sesión si se cumple alguna de las siguientes condiciones:
  • Creó la sesión.
  • Tiene una concesión session.configure sobre la sesión.
  • Tiene el permiso ManageOrgSessions a nivel de organización.
ManageOrgSessions solo es necesario para finalizar sesiones que el usuario de servicio no haya creado y sobre las que no tenga una concesión session.configure.

Notas

Una vez terminada, una sesión no se puede reanudar. Las sesiones terminadas siguen disponibles para consulta, tanto si las archivas como si no. Establece el parámetro archive en true para archivar también la sesión y sus sesiones descendientes. Al archivarlas, se marcan como archivadas (is_archived: true) y cualquier descendiente en ejecución pasa a dormir; no se conservan datos adicionales. Consulta Archivar sesión para obtener más información.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string | null
requerido

ID de la organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

devin_id
string | null
requerido

ID de sesión de Devin (prefijo: devin-)

Ejemplo:

"devin-abc123def456"

Parámetros de consulta

archive
boolean
predeterminado:false

Si se debe archivar la sesión de Devin

Respuesta

Respuesta exitosa

session_id
string
requerido
url
string
requerido
status
enum<string>
requerido
Opciones disponibles:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
requerido
org_id
string | null
requerido

Organización propietaria. Null para las sesiones desvinculadas, que pertenecen a la cuenta de su creador en lugar de a una organización.

created_at
integer
requerido
updated_at
integer
requerido
acus_consumed
number
requerido
pull_requests
SessionPullRequest · object[]
requerido
title
string | null
playbook_id
string | null
user_id
string | null
is_archived
boolean
predeterminado:false
parent_session_id
string | null
child_session_ids
string[] | null
service_user_id
string | null
category
enum<string> | null

La categoría de caso de uso asignada a la sesión, si se ha ejecutado la categorización. Solo se completa en los endpoints get/list.

Opciones 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
subcategory
string | null

El nombre visible de la subcategoría asignada a la sesión. 'Other' cuando se establece una categoría pero no se asignó ni se resolvió ninguna subcategoría. Solo se completa en los endpoints get/list.

origin
enum<string> | null

El origen desde el que se creó la sesión.

Opciones disponibles:
webapp,
slack,
teams,
api,
linear,
jira,
automation,
cli,
desktop,
code_scan,
other
automation_id
string | null

ID de la automatización que creó esta sesión, si la hubiera.

structured_output
Structured Output · object | null

Salida estructurada validada de la sesión. Solo se completa en los endpoints get/list.

devin_mode
enum<string> | null

El modo Agent de Devin con el que se creó la sesión, tras resolver los valores predeterminados de la organización o del usuario y la herencia de la sesión principal. None cuando la sesión ejecuta una vista previa del agente que no tiene un modo equivalente.

Opciones disponibles:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max
status_detail
enum<string> | null

Detalle adicional sobre el estado actual de la sesión. Cuando el estado es 'running': 'working' (trabajando activamente), 'waiting_for_user' (requiere información del usuario), 'waiting_for_approval' (a la espera de aprobación de una acción en modo seguro) o 'finished' (tarea completada). Cuando el estado es 'suspended': el motivo de la suspensión, como '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' o 'error'. Solo se completa en los endpoints get/list.

Opciones 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
on_demand_usage
number | null

Gasto bajo demanda (exceso de uso) en USD de esta sesión, excluidas las sesiones secundarias. Solo se rellena para los planes Teams; 0 si la cuota cubrió la sesión por completo. Se omite para otros planes. Solo se rellena en los endpoints get/list.

security_profile
SessionSecurityProfileResponse · object | null

La asociación de perfil de seguridad propia de la sesión. Solo se completa en los endpoints get/list.