Create a schedule

Creates a new scheduled task that will automatically run the agent based on the specified schedule.

Schedule Types:

• CRON (3): Use cronExpression to define a recurring schedule
• RunOnce (1): Requires startTime (must be at least 1 minute in the future) - runs once at the specified date/time
• RunEvery (2): Uses runEveryCount and runEveryPeriod (0=minutes, 1=hours, 2=days, 3=weeks, 4=months). Optional startTime for first run (must be in the future if provided).

StartTime Validation:

• For RunOnce: Required. Must be at least 1 minute in the future (UTC).
• For RunEvery: Optional. If provided, must be in the future (UTC). Determines when the first run occurs.
• For CRON: Not used. Schedule is determined by cronExpression.

CRON Schedule Example:

{
    "name": "Daily Morning Run",
    "scheduleType": 3,
    "cronExpression": "0 9 * * 1,4",
    "timezone": "America/New_York",
    "isEnabled": true
}

Run Once Example:

{
    "name": "One-time Run",
    "scheduleType": 1,
    "startTime": "2026-01-20T14:30:00Z",
    "timezone": "America/New_York",
    "isEnabled": true
}

Run Every Example (every 30 minutes):

{
    "name": "Frequent Check",
    "scheduleType": 2,
    "runEveryCount": 30,
    "runEveryPeriod": 0,
    "startTime": "2026-01-17T10:00:00Z",
    "timezone": "America/Denver",
    "isEnabled": true
}