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

# Workflow Schedules

> Run workflows on a cron schedule

## Overview

Scheduled runs are part of the current workflow system. Create a workflow, then attach a `cron` trigger with a cron expression and optional timezone.

<Note>
  Schedules are workflow triggers, not a separate `rt.schedules` SDK manager.
</Note>

## Create A Workflow

```typescript theme={null}
const saved = await rt.workflows.save({
  slug: 'daily-inbox-summary',
  name: 'Daily Inbox Summary',
  graph: {
    nodes: [
      {
        id: 'summarize',
        type: 'agent',
        config: {
          agent: 'email-assistant',
          prompt: 'Summarize important email since yesterday.',
        },
      },
    ],
    edges: [],
  },
});

await rt.workflows.publish('daily-inbox-summary', {
  visibility: 'org',
});
```

## Add A Cron Trigger

```typescript theme={null}
const trigger = await rt.workflows.createTrigger('daily-inbox-summary', {
  type: 'cron',
  name: 'Weekday morning',
  cronExpression: '0 9 * * 1-5',
  timezone: 'America/New_York',
  enabled: true,
});

console.log(trigger.trigger.id);
```

```bash cURL theme={null}
curl -X POST https://api.runtools.ai/v1/workflows/daily-inbox-summary/triggers \
  -H "X-API-Key: $RUNTOOLS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "cron",
    "name": "Weekday morning",
    "cronExpression": "0 9 * * 1-5",
    "timezone": "America/New_York",
    "enabled": true
  }'
```

## Cron Syntax

RunTools uses standard 5-field cron expressions: `minute hour day month weekday`.

| Cron           | Description          |
| -------------- | -------------------- |
| `0 9 * * *`    | Every day at 9:00 AM |
| `0 * * * *`    | Every hour           |
| `0 9 * * 1-5`  | Weekdays at 9:00 AM  |
| `*/15 * * * *` | Every 15 minutes     |

## Manage Triggers

```typescript theme={null}
const triggers = await rt.workflows.triggers('daily-inbox-summary');

await rt.workflows.updateTrigger(
  'daily-inbox-summary',
  triggers[0].id,
  {
    enabled: false,
  },
);

await rt.workflows.deleteTrigger('daily-inbox-summary', triggers[0].id);
```

## View Runs

```typescript theme={null}
const runs = await rt.workflows.runs('daily-inbox-summary', 20);
const events = await rt.workflows.events(runs[0].id);
```

```bash theme={null}
runtools workflow run daily-inbox-summary "Manual smoke run" --events
```

## CLI

```bash theme={null}
runtools workflow trigger list daily-inbox-summary
runtools workflow trigger create daily-inbox-summary \
  --type cron \
  --cron "0 9 * * 1-5" \
  --timezone America/New_York \
  --name "Weekday morning"
```