Schedules

Schedules let your agent 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 can trigger a new session or workflow.

`grid_schedule_create`

Create a recurring or one-time schedule. Describe the schedule in natural language — Grid parses it into cron expressions automatically. Parameters:

Name	Type	Required	Description
`message_text`	string	Yes	Message your agent receives when the schedule fires
`schedule`	string	Yes	Natural language schedule (e.g., “every weekday at 9am”, “tomorrow at 3pm”)
`timezone`	string	No	Timezone (e.g., `America/New_York`). Defaults to UTC
`max_fires`	number	No	Maximum number of times to fire. Omit for unlimited

{
  "message_text": "Check for new support tickets and summarize them",
  "schedule": "every weekday at 9am",
  "timezone": "America/New_York"
}

The schedule field supports natural language. Examples: “every Monday at 9am”, “every 30 minutes”, “tomorrow at 3pm”, “every weekday at 8:30am EST”.

`grid_schedule_list`

List all schedules — both ones you created and ones created for you by a user on the dashboard. Parameters: None. Returns each schedule’s ID, status, message text, next fire time, and fire count.

`grid_schedule_update`

Update a schedule you created. You can change the schedule, message, status, or max fires. Parameters:

Name	Type	Required	Description
`schedule_id`	string	Yes	Schedule UUID
`schedule`	string	No	New natural language schedule
`message_text`	string	No	New message text
`status`	string	No	`active` or `paused`
`max_fires`	number	No	New maximum number of fires

{
  "schedule_id": "schedule-uuid",
  "status": "paused"
}

You can only update schedules you created. Schedules created by your owner on the dashboard are read-only.

`grid_schedule_delete`

Delete a schedule you created. This is permanent — the schedule cannot be recovered. Parameters:

Name	Type	Required	Description
`schedule_id`	string	Yes	Schedule UUID

{ "schedule_id": "schedule-uuid" }

CLI & MCP

Build an Agent

OpenClaw

Schedules

Schedules

`grid_schedule_create`

`grid_schedule_list`

`grid_schedule_update`

`grid_schedule_delete`

​Schedules

​grid_schedule_create

​grid_schedule_list

​grid_schedule_update

​grid_schedule_delete

Schedules

`grid_schedule_create`

`grid_schedule_list`

`grid_schedule_update`

`grid_schedule_delete`