curl --request POST \
--url https://api.coval.dev/v1/scheduled-runs \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "Voice Agent Health Check",
"run_template_id": "abc123def456ghi789jklm",
"schedule_expression": "rate(15 minutes)",
"enabled": true
}
'{
"scheduled_run": {
"name": "scheduled-runs/xyz789uvw456rst123abcd",
"id": "xyz789uvw456rst123abcd",
"display_name": "Voice Agent Health Check",
"run_template_id": "abc123def456ghi789jklm",
"schedule_expression": "rate(15 minutes)",
"schedule_timezone": "UTC",
"enabled": true,
"last_run_at": null,
"last_run_id": null,
"create_time": "2025-10-14T12:00:00Z",
"update_time": null
}
}Create scheduled run
Create a new scheduled run that will trigger evaluations on a recurring schedule.
The schedule is defined using either:
- Rate expressions:
rate(15 minutes),rate(1 hour),rate(1 day) - Cron expressions:
cron(0 9 ? * MON-FRI *)(9am weekdays)
Schedules are created in an enabled state by default and will begin triggering at the next scheduled time.
curl --request POST \
--url https://api.coval.dev/v1/scheduled-runs \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"display_name": "Voice Agent Health Check",
"run_template_id": "abc123def456ghi789jklm",
"schedule_expression": "rate(15 minutes)",
"enabled": true
}
'{
"scheduled_run": {
"name": "scheduled-runs/xyz789uvw456rst123abcd",
"id": "xyz789uvw456rst123abcd",
"display_name": "Voice Agent Health Check",
"run_template_id": "abc123def456ghi789jklm",
"schedule_expression": "rate(15 minutes)",
"schedule_timezone": "UTC",
"enabled": true,
"last_run_at": null,
"last_run_id": null,
"create_time": "2025-10-14T12:00:00Z",
"update_time": null
}
}Authorizations
API key for authentication
Body
Human-readable schedule name
1 - 200"Voice Agent Health Check"
Run template to execute (must exist and be accessible)
^[A-Za-z0-9]{22}$"abc123def456ghi789jklm"
Schedule expression in rate or cron format.
Rate format: rate(value unit)
rate(15 minutes)- Every 15 minutesrate(1 hour)- Every hourrate(1 day)- Daily
Cron format: cron(minutes hours day-of-month month day-of-week year)
cron(0 9 ? * MON-FRI *)- 9am weekdayscron(0 2 ? * * *)- 2am daily
200"rate(15 minutes)"
IANA timezone for cron expressions.
Examples: UTC, America/New_York, Europe/London, Asia/Tokyo
100"America/New_York"
Whether to enable the schedule immediately
true
Response
Scheduled run created successfully
Scheduled run configuration resource.
Show child attributes
Show child attributes
Was this page helpful?