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

# Scheduler

> Run agents on a cron schedule.

Recurring runs are delegated to [Mage AI](https://www.mage.ai/), configured through the
`BASE_URL`, `API_KEY`, `OAUTH_TOKEN` and `PROJECT_NAME` variables.

```json theme={null}
POST /api/adk/schedule_run
{
  "agent_id": "agent42",
  "user_id": "user@example.com",
  "session_id": "session_scheduled",
  "new_message": {
    "role": "user",
    "parts": [{ "text": "Generate the daily report" }]
  },
  "schedule_interval": "@daily",
  "start_time": "2026-03-10T08:00:00"
}
```

## Presets

| Preset     | Cron                |
| ---------- | ------------------- |
| `@hourly`  | `0 * * * *`         |
| `@daily`   | `0 0 * * *`         |
| `@weekly`  | `0 0 * * 0`         |
| `@monthly` | `0 0 1 * *`         |
| Custom     | e.g. `*/15 * * * *` |

## Managing triggers

| Method | Endpoint                          | Description                   |
| ------ | --------------------------------- | ----------------------------- |
| GET    | `/api/pipelines`                  | List pipelines                |
| POST   | `/api/pipelines/agents/triggers`  | Create a trigger for an agent |
| GET    | `/api/pipelines/{uuid}/schedules` | List schedules                |
| PUT    | `/api/pipelines/schedules/{id}`   | Update                        |
| DELETE | `/api/pipelines/schedules/{id}`   | Delete                        |


## Related topics

- [Configuration](/configuration.md)
- [List Pipelines](/api-reference/scheduler/list-pipelines.md)
- [List Schedule Runs](/api-reference/scheduler/list-schedule-runs.md)
- [Update Pipeline Schedule](/api-reference/scheduler/update-pipeline-schedule.md)
- [Cancel Pipeline Run](/api-reference/scheduler/cancel-pipeline-run.md)