Schedules

Run an agent task on a recurring UTC cron schedule — a daily digest, a weekly report, a periodic check. Each firing is an ordinary agent run.

Create a schedule

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

body: name, cron_expr (5-field UTC cron), and task_text are required; optional 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
  }'

Manage & inspect

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

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

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

list, update (incl. pause via enabled), delete.

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

fire it immediately.

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

recent firings and their outcomes.

Each firing draws on the workspace balance like any agent run, bounded by the schedule's budget_usd. Pair with webhooks to be notified when a scheduled run finishes.