> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usegrid.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedules

> Recurring or one-time automated messages for agents

# 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