Create Session

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",
  "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>"
  ],
  "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>",
  "title": "<string>",
  "user_id": "<string>"
}

POST

v3beta1

organizations

{org_id}

sessions

Create Session

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",
  "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>"
  ],
  "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>",
  "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

Funcionalidad	Permiso requerido
`advanced_mode`	`UseDevinExpert`
`create_as_user_id`	`ImpersonateOrgSessions`

Modo avanzado

El parámetro advanced_mode habilita comportamientos especializados de sesión para flujos de trabajo de automatización. Cuando está activado, la sesión utiliza la persona avanzada y el prompt se transforma en función del modo seleccionado.

Modos disponibles

Modo	Descripción	Parámetros obligatorios
`analyze`	Analiza sesiones existentes de Devin para extraer información útil	`session_links`
`create`	Crea un nuevo playbook a partir del análisis de sesiones	Ninguno (opcional: `session_links`)
`improve`	Mejora un playbook existente en función de los comentarios	`child_playbook_id`
`batch`	Inicia varias sesiones de Devin para una lista de tareas	`child_playbook_id`
`manage`	Gestiona Knowledge	Ninguno

Opciones del modo por lotes

Al usar el modo batch, puedes opcionalmente 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 completamente automatizados en los que quieres que las sesiones comiencen de inmediato sin aprobación manual.

Suplantación de usuario

El parámetro create_as_user_id permite crear una sesión en nombre de otro usuario. Para ello se requiere:

Que el usuario de servicio tenga el permiso ImpersonateOrgSessions
Que el usuario de destino sea miembro de la organización
Que el usuario de destino tenga el permiso UseDevinSessions

Autorizaciones

Authorization

string

header

requerido

Service User credential (prefix: cog_)

Cuerpo

application/json

prompt

string

requerido

advanced_mode

enum<string> | null

Opciones disponibles:

analyze,

create,

improve,

batch,

manage

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_links

string[] | null

Respuesta

Successful Response

acus_consumed

number

requerido

created_at

integer

requerido

org_id

string

requerido

pull_requests

SessionPullRequest · object[]

requerido

Mostrar atributos secundarios

session_id

string

requerido

status

enum<string>

requerido

Opciones disponibles:

new,

claimed,

running,

exit,

error,

suspended,

resuming

Descripción general y conceptos

API v1 (con alcance de organización)

API v2 (administradores de Enterprise)

[Beta] API v3 (Usuarios de servicio)

Create Session

Permisos

Permisos adicionales para características avanzadas

Modo avanzado

Modos disponibles

Opciones del modo por lotes

Suplantación de usuario

Autorizaciones

Cuerpo

Respuesta

Descripción general y conceptos

API v1 (con alcance de organización)

API v2 (administradores de Enterprise)

[Beta] API v3 (Usuarios de servicio)

​Permisos

​Permisos adicionales para características avanzadas

​Modo avanzado

​Modos disponibles

​Opciones del modo por lotes

​Suplantación de usuario

Autorizaciones

Cuerpo

Respuesta

Permisos

Permisos adicionales para características avanzadas

Modo avanzado

Modos disponibles

Opciones del modo por lotes

Suplantación de usuario