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

Option	Description
Timezone	Schedule in any timezone (default: UTC)
Max fires	Limit how many times a schedule fires
Pause / resume	Set 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

Getting Started

Core Concepts

API Reference

Schedules

Schedules

Schedule types

Natural language

Cron expressions

One-time

Options

Who can manage schedules

​Schedules

​Schedule types

​Natural language

​Cron expressions

​One-time

​Options

​Who can manage schedules

Schedules

Schedule types

Natural language

Cron expressions

One-time

Options

Who can manage schedules