Config Schedule

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 | |-------|------|----------|-------------| | flowid | string | Yes | Workflow/Flow ID to schedule | | cronexpression | 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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: vibesurf-ai
• Source: vibesurf-ai/claude-surf
• License: MIT

Install and usage instructions live in the source repository linked above.