mirror of
https://github.com/Skyvern-AI/skyvern.git
synced 2026-04-28 11:40:32 +00:00
146 lines
6.5 KiB
Text
146 lines
6.5 KiB
Text
---
|
|
title: Schedule a Workflow
|
|
subtitle: Set up recurring cron-based execution from the UI
|
|
description: Set up recurring cron-based workflow schedules in the Skyvern Cloud UI, including creating, editing, pausing, and deleting schedules with timezone support.
|
|
slug: cloud/scheduling
|
|
keywords:
|
|
- schedule
|
|
- cron
|
|
- recurring
|
|
- timezone
|
|
- pause
|
|
- resume
|
|
- enable
|
|
- disable
|
|
---
|
|
|
|
You can schedule any workflow built in the Cloud UI to run automatically on a recurring basis. Schedules are configured with a cron expression and timezone, and Skyvern triggers the workflow at each interval.
|
|
|
|
This page covers scheduling through the Cloud UI. You can also create schedules programmatically via the SDK or API. See [Run from Code](/cloud/building-workflows/run-from-code) for the code approach.
|
|
|
|
Schedules are created as **active** by default: they start triggering runs immediately after creation.
|
|
|
|
When creating a schedule you'll fill in these fields:
|
|
|
|
- **Workflow** (required): The workflow to run. When creating from the workflow editor this is pre-selected.
|
|
- **Cron Expression** (required): A standard 5-field cron expression that defines how often the workflow runs (e.g., `0 9 * * 1-5` for every weekday at 9 AM). The UI validates the expression in real time and shows a human-readable translation. Quick presets are available for common patterns like hourly, daily, and weekly.
|
|
- **Timezone** (required): The IANA timezone the cron expression is evaluated in (e.g., `America/New_York`). Defaults to your browser's local timezone. The dropdown is searchable by city name.
|
|
- **Name**: A human-readable label to identify this schedule in the table and run history.
|
|
- **Description**: Optional notes about what this schedule does or why it exists.
|
|
|
|
<Warning>
|
|
The minimum interval between runs is **5 minutes**. Expressions that resolve to shorter intervals are rejected.
|
|
</Warning>
|
|
|
|
---
|
|
|
|
## Creating a schedule
|
|
|
|
<Tabs>
|
|
<Tab title="From the Schedules page">
|
|
<Steps>
|
|
<Step title="Open the Schedules page">
|
|
Click [**Schedules**](https://app.skyvern.com/schedules/) (calendar icon) in the left sidebar.
|
|
</Step>
|
|
<Step title="Click Create Schedule">
|
|
Click <kbd>Create Schedule</kbd> in the top right corner.
|
|
<img src="/images/cloud/create-schedule-button.png" alt="Schedules page with Create Schedule button in the top right corner" />
|
|
</Step>
|
|
<Step title="Select a workflow and configure the schedule">
|
|
Choose the workflow you want to schedule from the dropdown. Only saved workflows appear in this list. Then fill in the cron expression, timezone, and optionally a name and description. Check the **Next Scheduled Runs** preview to verify the upcoming execution times match your expectations.
|
|
<Frame>
|
|
<img src="/images/cloud/create-sched-form.png" alt="Schedule creation form with workflow dropdown, cron expression, timezone, name, and description fields" width="300" />
|
|
</Frame>
|
|
</Step>
|
|
<Step title="Create">
|
|
Click **Create Schedule**. The schedule starts in an **Active** state and triggers at the next scheduled time.
|
|
</Step>
|
|
</Steps>
|
|
</Tab>
|
|
<Tab title="From the workflow editor">
|
|
<Steps>
|
|
<Step title="Open the workflow">
|
|
Navigate to [**Workflows**](https://app.skyvern.com/workflows/) in the sidebar and click the workflow you want to schedule.
|
|
</Step>
|
|
<Step title="Click the Schedule button">
|
|
In the editor header bar, click the <kbd>Schedule</kbd> button (clock icon).
|
|
<img src="/images/cloud/wf-page-sched.png" alt="Workflow editor page with Schedule button (clock icon) in the header bar" />
|
|
</Step>
|
|
<Step title="Click Add and configure the schedule">
|
|
A panel opens showing any existing schedules for this workflow. Click <kbd>Add</kbd> to create a new one. Fill in the cron expression, timezone, and optionally a name and description. The workflow is already selected.
|
|
<Frame>
|
|
<img src="/images/cloud/create-sched-form.png" alt="Schedule creation form with cron expression, timezone, name, and description fields" width="300" />
|
|
</Frame>
|
|
</Step>
|
|
<Step title="Create">
|
|
Click **Create Schedule**. The schedule appears in the panel and starts immediately.
|
|
</Step>
|
|
</Steps>
|
|
</Tab>
|
|
</Tabs>
|
|
|
|
---
|
|
|
|
## The Schedules page
|
|
|
|
Click **Schedules** in the left sidebar to see every schedule across all workflows.
|
|
|
|
Each row shows:
|
|
|
|
| Column | What it shows |
|
|
|--------|--------------|
|
|
| **Workflow** | The workflow this schedule triggers |
|
|
| **Name** | Schedule name |
|
|
| **Schedule** | Human-readable cron description (e.g., "Every weekday at 9:00 AM") |
|
|
| **Next Run** | Next execution time in your local timezone |
|
|
| **Status** | **Active** (green) or **Paused** (gray) |
|
|
|
|
Use the search bar to filter by schedule name or workflow title. The status filter narrows to Active or Paused schedules.
|
|
|
|
---
|
|
|
|
## Editing a schedule
|
|
|
|
Click a schedule row to open its detail page.
|
|
|
|
<img src="/images/cloud/sched-page.png" alt="Schedule detail page showing configuration, details, and upcoming runs sections" />
|
|
|
|
On this page, you can:
|
|
|
|
- **Edit the schedule configuration**: Click the **Edit** button to change the frequency, timezone, cron expression, name, and description. Changes take effect immediately and the **Upcoming Runs** preview updates to reflect the new configuration.
|
|
- **View schedule details**: See when the schedule was created and last modified.
|
|
- **Preview upcoming runs**: Check the next 5 scheduled execution times in the **Upcoming Runs** section.
|
|
- **Pause or resume**: Toggle the **Status** switch to pause the schedule. Paused schedules keep their configuration and can be resumed at any time: no runs are triggered while paused.
|
|
- **Delete the schedule**: Use the delete button (trash icon) in the header. Deletion is permanent. Runs already triggered by the schedule are not affected.
|
|
|
|
<Info>
|
|
To change which workflow a schedule runs, delete the schedule and create a new one for the target workflow.
|
|
</Info>
|
|
|
|
---
|
|
|
|
## What's next
|
|
|
|
<CardGroup cols={3}>
|
|
<Card
|
|
title="Scheduling API"
|
|
icon="code"
|
|
href="/cloud/building-workflows/run-from-code#create-a-schedule"
|
|
>
|
|
Create and manage schedules programmatically
|
|
</Card>
|
|
<Card
|
|
title="Run History"
|
|
icon="clock-rotate-left"
|
|
href="/cloud/viewing-results/run-history"
|
|
>
|
|
View and filter results from scheduled runs
|
|
</Card>
|
|
<Card
|
|
title="Cost Control"
|
|
icon="gauge"
|
|
href="/developers/optimization/cost-control"
|
|
>
|
|
Manage costs for recurring automations
|
|
</Card>
|
|
</CardGroup>
|