Schedule

Activa o desactiva el sync programado de una conexión y define su frecuencia. Cuando está activo, Nodda dispara syncs automáticamente al llegar la próxima corrida programada.

Configurar el schedule

PUT /connections/{id}/schedule

Cuerpo:

Campo	Tipo	Notas
`enabled`	boolean	si el sync programado queda activo
`frequency_minutes`	number \| null	intervalo en minutos. Requerido (no `null`) cuando `enabled` es `true`. Debe ser uno de: `60`, `360`, `720`, `1440`. Pasar `null` cuando `enabled` es `false`

Frecuencias permitidas:

`frequency_minutes`	Cadencia
`60`	cada hora
`360`	cada 6 horas
`720`	cada 12 horas
`1440`	cada 24 horas

Activar

curl -X PUT https://app.nodda.cl/api/connections/3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b/schedule \
  -H "Authorization: Bearer nodda_sk_tu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "frequency_minutes": 1440 }'

Respuesta (200):

{
  "data": {
    "enabled": true,
    "frequency_minutes": 1440,
    "next_scheduled_sync_at": "2026-06-10T00:00:00.000Z"
  }
}

Desactivar

curl -X PUT https://app.nodda.cl/api/connections/3f1c9e2a-7b44-4d51-9a0e-1c2d3e4f5a6b/schedule \
  -H "Authorization: Bearer nodda_sk_tu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false, "frequency_minutes": null }'

Respuesta (200):

{
  "data": {
    "enabled": false,
    "frequency_minutes": null,
    "next_scheduled_sync_at": null
  }
}

Cómo se calcula la próxima corrida

next_scheduled_sync_at se computa al activar el schedule: se trunca la hora actual (UTC) al inicio de la hora y se le suma frequency_minutes. Las corridas programadas usan trigger: "scheduled" y se saltan si ya hay una corrida en vuelo (queued/running) para esa conexión.

Errores

Código	HTTP	Cuándo
`validation_error`	400	cuerpo inválido
`connection_not_found`	404	la conexión no existe en tu organización
`schedule_invalid_frequency`	422	`frequency_minutes` fuera de `{60, 360, 720, 1440}` con `enabled: true`

Catálogo completo en Errores.