Config Schedule - Workflow Schedule Management

Overview

Manage scheduled workflow executions using cron expressions. Schedule workflows to run automatically at specified times.

When to Use

• User wants to schedule a workflow to run automatically
• User needs to set up cron-based workflow triggers
• User wants to enable/disable existing schedules
• User needs to view or update workflow schedules
• User wants to see which workflows have schedules configured

API Endpoints

Base path: $VIBESURF_ENDPOINT/api/schedule

Schedule Management

Action	Method	Endpoint	Description
List Schedules	GET	/api/schedule	Get all workflow schedules
Get Schedule	GET	/api/schedule/{flow_id}	Get schedule for specific workflow
Create Schedule	POST	/api/schedule	Create new schedule for a workflow
Update Schedule	PUT	/api/schedule/{flow_id}	Update existing schedule

Request Examples

Create Schedule

POST /api/schedule
{
  "flow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "cron_expression": "0 9 * * 1-5",
  "is_enabled": true,
  "description": "Run every weekday at 9 AM"
}

Update Schedule

PUT /api/schedule/{flow_id}
{
  "cron_expression": "0 12 * * *",
  "is_enabled": true,
  "description": "Run daily at noon"
}

Enable/Disable Schedule

PUT /api/schedule/{flow_id}
{
  "is_enabled": false
}

Schedule Fields

Field	Type	Required	Description
flow_id	string	Yes	Workflow/Flow ID to schedule
cron_expression	string	No	Cron expression (e.g., '0 9 * * 1-5')
is_enabled	bool	No	Whether the schedule is active
description	string	No	Description of the schedule

Cron Expression Format

Standard cron format: minute hour day_of_month month day_of_week

Expression	Description
0 9 * * 1-5	Every weekday at 9:00 AM
0 12 * * *	Every day at 12:00 PM
0 */6 * * *	Every 6 hours
0 0 * * 0	Every Sunday at midnight
0 8,20 * * *	At 8:00 AM and 8:00 PM daily

Workflow

1. Get workflow ID → From existing workflows or import
2. Create schedule → POST /api/schedule with cron expression
3. Verify schedule → GET /api/schedule/{flow_id} to confirm
4. Update as needed → PUT /api/schedule/{flow_id} to modify

Notes

• Each workflow can only have one schedule
• Schedules are automatically reloaded after creation/update
• The schedule manager must be running for schedules to execute
• next_execution_at is automatically calculated from the cron expression