Crear una programación

Crear una nueva sesión programada.

POST /v3/organizations/{org_id}/schedules

Crear una programación

cURL

curl --request POST \
  --url https://api.devin.ai/v3/organizations/{org_id}/schedules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "prompt": "<string>",
  "agent": "devin",
  "bypass_approval": false,
  "create_as_user_id": "<string>",
  "frequency": "<string>",
  "interval_count": 1,
  "notify_on": "failure",
  "platform": "<string>",
  "playbook_id": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}
'

200

{
  "consecutive_failures": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "enabled": true,
  "frequency": "<string>",
  "last_error_at": "2023-11-07T05:31:56Z",
  "last_error_message": "<string>",
  "last_executed_at": "2023-11-07T05:31:56Z",
  "name": "<string>",
  "org_id": "<string>",
  "playbook": {
    "playbook_id": "<string>",
    "title": "<string>"
  },
  "prompt": "<string>",
  "scheduled_session_id": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "bypass_approval": false,
  "interval_count": 1,
  "last_edited_by": "<string>",
  "platform": "<string>",
  "schedule_type": "recurring",
  "scheduled_at": "2023-11-07T05:31:56Z",
  "slack_channel_id": "<string>",
  "slack_team_id": "<string>",
  "tags": [
    "<string>"
  ],
  "target_devin_id": "<string>"
}

​

Permisos

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

​

Tipo de programación

El campo schedule_type controla si la programación es recurrente o única:

• recurring (predeterminado): requiere el campo frequency con una expresión cron
• one_time: requiere el campo scheduled_at con una fecha y hora en formato ISO 8601 en el futuro

​

Frecuencia

Para programaciones recurrentes, el campo frequency acepta una expresión cron estándar (por ejemplo, 0 9 * * 1-5 para los días laborables a las 9:00 UTC).

​

Programado para

Para programaciones únicas, el campo scheduled_at acepta una fecha y hora en formato ISO 8601 con zona horaria (por ejemplo, 2026-03-01T09:00:00Z). La fecha y hora deben estar en el futuro. Después de ejecutarse, la programación se deshabilita automáticamente.

​

Tipos de agentes

Agente	Descripción
devin	Agente Devin estándar (predeterminado)
data_analyst	Agente analista de datos
advanced	Agente avanzado

​

Suplantación de usuario

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

1. El usuario de servicio debe tener el permiso ImpersonateOrgSessions
2. El usuario de destino debe ser miembro de la organización
3. El usuario de destino debe tener el permiso UseDevinSessions

Autorizaciones

Authorization · string · header · requerido

Credencial de usuario de servicio (prefijo: cog_)

Cuerpo

application/json

name · string · requerido

prompt · string · requerido

agent · enum<string> · predeterminado: devin

Opciones disponibles: devin, data_analyst

bypass_approval · boolean · predeterminado: false

create_as_user_id · string | null

frequency · string | null

interval_count · integer · predeterminado: 1

notify_on · enum<string> · predeterminado: failure

Opciones disponibles: always, failure, never

platform · string | null

Plataforma de VM para las sesiones generadas por esta programación (p. ej., 'windows'). Si se omite, las sesiones usarán la plataforma predeterminada de la organización en el momento de la activación. El valor debe coincidir con una plataforma configurada para la organización (sin distinguir mayúsculas de minúsculas); los valores desconocidos se rechazan con un 400 que enumera las etiquetas de plataforma disponibles.

playbook_id · string | null

schedule_type · enum<string> · predeterminado: recurring

Opciones disponibles: recurring, one_time

scheduled_at · string<date-time> | null

slack_channel_id · string | null

slack_team_id · string | null

tags · string[] | null

target_devin_id · string | null

Respuesta

200

application/json

Respuesta satisfactoria

agent · enum<string> · requerido

Opciones disponibles: devin, data_analyst

consecutive_failures · integer · requerido

created_at · string<date-time> · requerido

created_by · string | null · requerido

enabled · boolean · requerido

frequency · string | null · requerido

last_error_at · string<date-time> | null · requerido

last_error_message · string | null · requerido

last_executed_at · string<date-time> | null · requerido

name · string · requerido

notify_on · enum<string> · requerido

Opciones disponibles: always, failure, never

org_id · string · requerido

playbook · PlaybookInfo · object · requerido

Show child attributes

prompt · string · requerido

scheduled_session_id · string · requerido

updated_at · string<date-time> · requerido

bypass_approval · boolean · predeterminado: false

interval_count · integer · predeterminado: 1

last_edited_by · string | null

platform · string | null

schedule_type · enum<string> · predeterminado: recurring

Opciones disponibles: recurring, one_time

scheduled_at · string<date-time> | null

slack_channel_id · string | null

slack_team_id · string | null

tags · string[] | null

target_devin_id · string | null