Schedules

繰り返しの UTC cron スケジュールで agent タスクを実行します——デイリーダイジェスト、週次レポート、定期チェックなど。各発火は通常の agent run です。

スケジュールの作成

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

ボディ：name、cron_expr（5 フィールドの UTC cron）、task_text が必須；任意で 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
  }'

管理と確認

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

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

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

一覧、更新（enabled による一時停止を含む）、削除。

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

即座に発火させます。

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

直近の発火とその結果。

各発火は他の agent run と同様にワークスペース残高を消費し、スケジュールの budget_usd で制限されます。webhooks と組み合わせれば、スケジュールされた run の完了時に通知を受け取れます。