Scheduling & Cron

Automate task execution with flexible scheduling options.

Overview

Schedule types:

• Once - Execute at specific time
• Delayed - Execute after delay
• Cron - Recurring with cron expressions

Creating Schedules

Via Dashboard

1. Navigate to Schedules
2. Click New Schedule
3. Select type (once, delayed, cron)
4. Configure timing
5. Select callback (workflow)
6. Save

Cron Builder

Use the visual cron builder:

• Select frequency
• Pick specific times
• Preview next runs
• Generate expression

Cron Expressions

Format

┌───────────── minute (0-59)
│ ┌───────────── hour (0-23)
│ │ ┌───────────── day of month (1-31)
│ │ │ ┌───────────── month (1-12)
│ │ │ │ ┌───────────── day of week (0-6)
│ │ │ │ │
* * * * *

Common Patterns

Expression	Description
0 9 * * *	Daily at 9:00 AM
0 9 * * 1	Every Monday at 9:00 AM
0 */2 * * *	Every 2 hours
0 9-17 * * 1-5	Hourly 9-5 on weekdays

Callback Types

Workflow

Trigger a workflow:

{
  "callback_type": "workflow",
  "callback_id": "my-workflow-id"
}

Function

Call a specific function:

{
  "callback_type": "function",
  "callback_id": "processData"
}

Built-in autonomy callbacks

These callback strings are recognized by the agent's alarm dispatcher and don't require any workflow. They're idempotently seeded on first agent wake so every agent gets the daily self-maintenance jobs out of the box.

Callback	Cron	What it does
reflection:24h	0 3 * * * (03:00 UTC)	Run a daily self-review over the last 24 hours. Produces a row in agent_reflections, may update agent_goals and write memory:reflection:* keys. See Goals & Reflection.
consolidate-memory	0 4 * * * (04:00 UTC)	Cluster + merge near-duplicate memories and decay stale ones. See Agent Memory.
reindex-workflows	0 5 * * * (05:00 UTC)	Re-embed workflows whose description+nodes have changed since the last pass. Hash-gated so unchanged workflows are skipped cheaply.

The reflection: callback also accepts a period override:

{
  "callback_type": "function",
  "callback_id": "reflection:7d"
}

Valid period suffixes: Ns (seconds), Nm (minutes), Nh (hours), Nd (days). Default 24h if omitted.

Event-driven reflection: error_spike

Not a cron — a runtime trigger. When more than 5 workflow failures land in a 10-minute window, the agent fires an ad-hoc reflection with trigger='error_spike'. Throttled to once every 30 minutes so a sustained incident doesn't generate runaway reflections.

Schedule Status

Status	Description
active	Running
paused	Temporarily disabled
completed	One-time finished

Management

Pause

Temporarily disable:

curl -X PUT .../schedules/{id} -d '{"status": "paused"}'

Resume

Re-enable:

curl -X PUT .../schedules/{id} -d '{"status": "active"}'

API Reference

See Schedules API for complete endpoint documentation.