Schedules

Execute uma tarefa de agent em um cron UTC recorrente — um digest diário, um relatório semanal, uma checagem periódica. Cada disparo é um agent run comum.

Criar um schedule

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

body: name, cron_expr (cron UTC de 5 campos) e task_text são obrigatórios; opcionais 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
  }'

Gerenciar e inspecionar

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

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

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

listar, atualizar (incl. pausar via enabled), excluir.

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

dispara imediatamente.

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

disparos recentes e seus resultados.

Cada disparo consome do saldo do workspace como qualquer agent run, limitado pelo budget_usd do schedule. Combine com webhooks para ser notificado quando um run agendado termina.