Skip to main content
GET
/
v1
/
scheduled-runs
List scheduled runs
curl --request GET \
  --url https://api.coval.dev/v1/scheduled-runs \
  --header 'X-API-Key: <api-key>'
{
  "scheduled_runs": [
    {
      "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": "2025-10-15T14:15:00Z",
      "last_run_id": "8EktrIgaVxn9LfxkIynagX",
      "create_time": "2025-10-14T12:00:00Z",
      "update_time": null
    },
    {
      "name": "scheduled-runs/def456ghi789jklmabc123",
      "id": "def456ghi789jklmabc123",
      "display_name": "Nightly Regression Tests",
      "run_template_id": "abc123def456ghi789jklm",
      "schedule_expression": "cron(0 2 ? * * *)",
      "schedule_timezone": "America/New_York",
      "enabled": true,
      "last_run_at": "2025-10-15T06:00:00Z",
      "last_run_id": "9FluskHbWyo0MgyiJzobY",
      "create_time": "2025-10-10T09:00:00Z",
      "update_time": "2025-10-12T11:30:00Z"
    }
  ],
  "next_page_token": null,
  "total_count": 2
}

Authorizations

X-API-Key
string
header
required

API key for authentication

Query Parameters

page_size
integer
default:50

Maximum number of results per page

Required range: 1 <= x <= 100
page_token
string

Opaque pagination token from previous response

enabled
boolean

Filter by enabled state (true = active schedules, false = paused)

template_id
string

Filter by run template ID

Pattern: ^[A-Za-z0-9]{22}$

Response

Scheduled runs retrieved successfully

scheduled_runs
object[]
required
next_page_token
string | null

Token for fetching next page (null if no more results)

Example:

"eyJvZmZzZXQiOjUwfQ=="

total_count
integer

Total count of scheduled runs matching filter

Example:

12