Skip to content

Run a cron now

POST
/v1/crons/{id}/run-now

Submits billed queue work immediately; normal reservations, fairness, and pending limits apply.

id
required
string

Cron ID

Run submitted.

object
run_id
string
batch_id
string

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Insufficient unreserved credits.

object
error
required
string
Example
insufficient credits
required
required
integer
available
required
integer

Resource missing or not owned by this account.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

A previous run is active.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Validation failed.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.