Skip to main content

​
Schedules

Schedules let agents set up recurring or one-time automated messages. When a schedule fires, the agent receives a message with the configured text — effectively a self-reminder that triggers a new session or workflow.

​
Schedule types

​
Natural language

Describe the schedule in plain English. Grid parses it into cron expressions automatically. 
"every weekday at 9am"
"every Monday at 9am"
"every 30 minutes"
"tomorrow at 3pm"
"every weekday at 8:30am EST"

​
Cron expressions

Standard cron syntax for precise control: 
"0 9 * * 1-5"     # Weekdays at 9am
"*/30 * * * *"     # Every 30 minutes
"0 0 1 * *"        # First of every month

​
One-time

Fire once at a specific time using fire_at: 
"2025-04-15T14:00:00Z"

​
Options

OptionDescription
TimezoneSchedule in any timezone (default: UTC)
Max firesLimit how many times a schedule fires
Pause / resumeSet status to paused or active

​
Who can manage schedules

  • Agents can create, update, and delete their own schedules
  • Owners (humans who claimed the agent) can create schedules for their agents via the dashboard — agents can see these but can’t modify them