Saltar al contenido principal
POST
Crear sesión

Permisos

Requiere un usuario de servicio o un token de acceso personal con el permiso UseDevinSessions (org.devins.use) a nivel de la organización.

Permisos adicionales para características avanzadas

Modo de Devin

El parámetro devin_mode controla qué modo Agent de Devin se usa en la sesión: Si se omite, la sesión usa el modo predeterminado de la organización. Los modos en vista previa están sujetos a las mismas restricciones de feature flag y de vista previa del agente de Enterprise que la aplicación web.

Suplantación de usuario

El parámetro create_as_user_id permite crear una sesión en nombre de otro usuario. Esto requiere:
  1. El usuario de servicio debe tener el permiso ImpersonateOrgSessions
  2. El usuario objetivo debe ser miembro de la organización
  3. El usuario objetivo debe tener el permiso UseDevinSessions

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string | null
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

Parámetros de consulta

devin_id
string | null

Cuerpo

application/json
prompt
string
requerido
title
string | null
tags
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
knowledge_ids
string[] | null
secret_ids
string[] | null
session_secrets
SessionSecretInput · object[] | null
repos
string[] | null
attachment_urls
string<uri>[] | null
Required string length: 1 - 2083
create_as_user_id
string | null
child_playbook_id
string | null
bypass_approval
boolean | null
security_profile
SessionSecurityProfileSelection · object | null

Asocia un perfil de seguridad a esta sesión; si se omite, se aplica la resolución predeterminada (se usa el perfil de seguridad del manual de procedimientos si tiene uno asociado; en caso contrario, el predeterminado de la organización/Enterprise). Requiere el permiso de gestión de perfiles de seguridad.

structured_output_schema
Structured Output Schema · object | null

JSON Schema (Draft 7) para validar Structured Output. Máx. 64 KB. Debe ser autocontenido (sin $ref externos).

structured_output_required
boolean | null

Cuando es true (predeterminado), el agente DEBE llamar a provide_structured_output con is_final=true antes de que termine su turno. Cuando es false, la herramienta está disponible pero no es obligatoria; no se garantiza que se invoque en un turno determinado.

resumable
boolean
predeterminado:true

Si se debe conservar el estado de la VM de la sesión después de detenerse para poder reanudarla. Establézcalo en false para sesiones desechables.

memory_enabled
boolean | null

Establezca el valor en false para mantener desactivada la memoria en esta sesión y sus sesiones secundarias: estas no leen ni escriben en la memoria, y la memoria no aprende de sus transcripciones. Omítalo o establézcalo en true para aplicar la configuración de memoria del propietario; true no activa la memoria si esa configuración la mantiene desactivada.

platform
string | null

Anula la plataforma de VM de la sesión (p. ej., 'windows') o el nombre de un pool de outpost (BYOB) para ejecutar la sesión en una de tus propias máquinas. Si se omite (o se establece en 'inherit'), una sesión creada por un Devin padre hereda la asignación del padre, tanto su plataforma como su pool de outpost; de este modo, un padre asignado a un outpost crea sesiones secundarias en el mismo pool. En caso contrario, se usa el valor predeterminado de la organización. Cualquier valor debe coincidir con una plataforma configurada para tu organización o con un nombre de pool de outpost (sin distinguir entre mayúsculas y minúsculas); las plataformas integradas tienen prioridad cuando un nombre coincide con ambos, y un pool de outpost personal del solicitante tiene prioridad sobre un pool compartido por toda la cuenta con el mismo nombre. Los valores no reconocidos se rechazan con un 400 cuyo cuerpo de error enumera las etiquetas de plataforma disponibles y los nombres de pool de outpost de la organización.

devin_mode
enum<string> | null

Anula el modo Agent de Devin para la sesión. 'normal' usa el modo Agent predeterminado, 'fast' usa el modo Fast, 'lite' usa Devin Lite, 'ultra' usa Devin Ultra y 'fusion' usa Fusion. Los demás valores seleccionan el modo Agent del mismo nombre en la web app. Los modos de vista previa están sujetos al mismo flag de función y a las mismas restricciones de vista previa del agente en Enterprise que la web app.

Opciones disponibles:
normal,
fast,
fusion,
lite,
ultra,
fast-ultra,
swe-2-medium,
swe-2-high,
swe-2-max

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.