Schedules

Ejecuta una tarea de agent con una programación cron UTC recurrente: un resumen diario, un informe semanal, una comprobación periódica. Cada disparo es una agent run normal.

Crear una programación

POST/v1/workspaces/{workspace_id}/schedules —

body: name, cron_expr (cron UTC de 5 campos) y task_text son obligatorios; opcionales: project_id, model_id, max_steps, budget_usd, enabled.

bash

curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/schedules \
  -H "Authorization: Bearer $NEXEVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily FX digest",
    "cron_expr": "0 7 * * *",
    "task_text": "Summarize overnight moves in USD/SGD and EUR/USD.",
    "budget_usd": 0.3
  }'

Gestión e inspección

GET/v1/workspaces/{workspace_id}/schedules —

PATCH/v1/workspaces/{workspace_id}/schedules/{schedule_id} —

DELETE/v1/workspaces/{workspace_id}/schedules/{schedule_id} —

lista, actualiza (incluida la pausa vía enabled) y elimina.

POST/v1/workspaces/{workspace_id}/schedules/{schedule_id}/run-now —

la dispara de inmediato.

GET/v1/workspaces/{workspace_id}/schedules/{schedule_id}/runs —

disparos recientes y sus resultados.

Cada disparo consume del saldo del workspace como cualquier agent run, acotado por el budget_usd de la programación. Combínalo con webhooks para que te avisen cuando termina una run programada.