Skip to Content
AI AgentScheduled Tasks

Scheduled Agent Tasks

The agent can execute tasks on a recurring schedule — like daily reports, weekly cleanups, or periodic checks.

Examples

  • “Every morning at 8 AM, summarize pending orders”
  • “Weekly on Monday, generate a shipping cost report”
  • “Every 4 hours, check for orders stuck in processing”

Creating Scheduled Tasks

Portal

Go to Agent > Scheduled Tasks and define:

  • The task description (natural language)
  • The schedule (cron expression or simple interval)
  • Whether results should be posted to the conversation

API

POST /api/agent/scheduled-tasks
Content-Type: application/json
 
{
  "description": "Summarize pending orders and flag any over 48 hours old",
  "schedule": "0 8 * * *",
  "notifyOnComplete": true
}

Execution

Scheduled tasks run as the agent:

  1. The scheduler triggers the task at the specified time
  2. The agent executes the described action
  3. If the task proposes changes, they become pending actions
  4. Results are posted to the conversation (if configured)

Managing

GET /api/agent/scheduled-tasks
PATCH /api/agent/scheduled-tasks/:id
DELETE /api/agent/scheduled-tasks/:id
Standing OrdersPermissions