Saltar al contenido principal
POST
/
v3beta1
/
organizations
/
{org_id}
/
sessions
Crear sesión
curl --request POST \
  --url https://api.devin.ai/v3beta1/organizations/{org_id}/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "advanced_mode": "analyze",
  "attachment_urls": [
    "<string>"
  ],
  "bypass_approval": true,
  "child_playbook_id": "<string>",
  "create_as_user_id": "<string>",
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 123,
  "playbook_id": "<string>",
  "repos": [
    "<string>"
  ],
  "secret_ids": [
    "<string>"
  ],
  "session_links": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": 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>",
  "status": "new",
  "tags": [
    "<string>"
  ],
  "updated_at": 123,
  "url": "<string>",
  "child_session_ids": [
    "<string>"
  ],
  "is_advanced": false,
  "is_archived": false,
  "parent_session_id": "<string>",
  "structured_output": {},
  "title": "<string>",
  "user_id": "<string>"
}

Permisos

Requiere un usuario de servicio con el permiso ManageOrgSessions a nivel de la organización.

Permisos adicionales para características avanzadas

FuncionalidadPermiso requerido
advanced_modeUseDevinExpert
create_as_user_idImpersonateOrgSessions

Modo avanzado

El parámetro advanced_mode habilita comportamientos de sesión especializados para flujos de trabajo de automatización. Cuando está activado, la sesión utiliza el perfil avanzado y el prompt se transforma según el modo seleccionado.

Modos disponibles

ModeDescriptionRequired Parameters
analyzeAnalizar sesiones existentes de Devin para obtener información útilsession_links
createCrear un nuevo playbook basado en el análisis de sesionesNinguno (opcional: session_links)
improveMejorar un playbook existente a partir de comentarioschild_playbook_id
batchIniciar múltiples sesiones de Devin para una lista de tareaschild_playbook_id
manageAdministrar KnowledgeNinguno

Opciones del modo por lotes

Cuando uses el modo batch, puedes, de forma opcional, establecer bypass_approval en true para omitir el paso de aprobación en la creación de sesiones por lotes. Esto es útil para flujos de trabajo totalmente automatizados en los que quieres que las sesiones comiencen de inmediato sin aprobación manual.

Suplantación de usuarios

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 contar con el permiso ImpersonateOrgSessions
  2. El usuario de destino debe ser miembro de la organización
  3. El usuario de destino debe contar con el permiso UseDevinSessions

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Cuerpo

application/json
prompt
string
requerido
advanced_mode
enum<string> | null
Opciones disponibles:
analyze,
create,
improve,
batch,
manage
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
knowledge_ids
string[] | null
max_acu_limit
integer | null
playbook_id
string | null
repos
string[] | null
secret_ids
string[] | null
session_secrets
SessionSecretInput · object[] | null
structured_output_schema
Structured Output Schema · object

Esquema JSON (Draft 7) para validar la salida estructurada. Máx. 64 KB. Debe ser autocontenido (sin $ref externos).

tags
string[] | null
title
string | null

Respuesta

Respuesta satisfactoria

acus_consumed
number
requerido
created_at
integer
requerido
org_id
string
requerido
pull_requests
SessionPullRequest · object[]
requerido
session_id
string
requerido
status
enum<string>
requerido
Opciones disponibles:
new,
claimed,
running,
exit,
error,
suspended,
resuming
tags
string[]
requerido
updated_at
integer
requerido
url
string
requerido
child_session_ids
string[] | null
is_advanced
boolean
predeterminado:false
is_archived
boolean
predeterminado:false
parent_session_id
string | null
structured_output
Structured Output · object

Salida estructurada validada de la sesión. Solo se incluye en endpoints GET/LIST.

title
string | null
user_id
string | null