Scheduled Tasks API

Manage cron-based scheduled agent executions.

Base URL: https://api.bluenexus.ai/api/v1/agents/:agentId/scheduled-tasks

POST /agents/:agentId/scheduled-tasks

Create a scheduled task.

Auth: Bearer token with agents-all scope

{
  "name": "Daily Summary",
  "prompt": "Summarize yesterday's Slack activity and post to #standup",
  "cronExpression": "0 9 * * 1-5",
  "timezone": "America/New_York",
  "enabled": true
}

Response (201):

{
  "id": "task-abc123",
  "agentId": "agent-xyz",
  "name": "Daily Summary",
  "prompt": "Summarize yesterday's Slack activity...",
  "cronExpression": "0 9 * * 1-5",
  "timezone": "America/New_York",
  "enabled": true,
  "createdAt": "2026-04-13T10:00:00Z",
  "updatedAt": "2026-04-13T10:00:00Z"
}

---

GET /agents/:agentId/scheduled-tasks

List scheduled tasks for an agent.

---

GET /agents/:agentId/scheduled-tasks/:taskId

Get a specific task.

---

PUT /agents/:agentId/scheduled-tasks/:taskId

Update a task (name, prompt, cron, timezone, enabled).

---

DELETE /agents/:agentId/scheduled-tasks/:taskId

Delete a task.

---

Cron Format

Standard 5-field cron expression: minute hour day-of-month month day-of-week

Expression	Schedule
0 9 * * 1-5	Weekdays at 9 AM
0 */2 * * *	Every 2 hours
30 8 1 * *	8:30 AM on the 1st
0 0 * * 0	Midnight every Sunday