List schedule runs

GET

/api/v1/schedules/runs

Code sample: cURL

curl -X GET 'https://api.justcrawl.io/api/v1/schedules/runs?limit=20' \
  -H 'Authorization: Bearer $JUSTCRAWL_API_KEY'

• Production

Returns recent schedule executions across the org, newest first. Each run groups the jobs dispatched by one firing of a schedule, so a runId is the handle for correlating a batch of jobs back to the schedule that produced them.

Authorizations

• bearerAuth

Parameters

Query Parameters

scheduleId

string format: uuid

Only return runs of this schedule.

runId

string format: uuid

Look up one specific run.

domain

string

Only return runs that targeted this domain.

search

string

Free-text match against the schedule name.

limit

integer

default: 50 >= 1 <= 200

Maximum runs to return. Values above 200 are clamped.

Responses

200

Matching schedule runs, newest first.

Media typeapplication/json

Array<object>

object

Example^generated

[
  {}
]

400

runId is not a valid UUID.

401

Missing or invalid authentication token

Media typeapplication/json

object

error

string

Example

{
  "error": "Missing or invalid authentication token"
}

403

Insufficient permissions for this operation

Media typeapplication/json

object

error

string

Example

{
  "error": "No organization. Complete onboarding first."
}

500

Unexpected server error. Logs and PostHog $exception capture

Media typeapplication/json

object

error

string

Example

{
  "error": "Something went wrong"
}