Skip to main content
POST
Run a schedule now

Authorizations

Authorization
string
header
required

The opaque agt_r token minted when the runner enrols (POST /v1/runners)

Path Parameters

lease_id
string
required

UUIDv7 of the lease.

schedule_id
string
required

UUIDv7 of the schedule.

Body

application/json

POST /v1/runners/me/leases/{lease_id}/schedules/{schedule_id}/runs request: run the schedule now.

fencing_token
integer<int64>
required

The lease's fencing token; a holder the fleet has superseded is refused.

Required range: x >= 0

Response

The run that was created

What running a schedule now admitted.

event_id
string
required

The event that is the new run. Beta: this field may change shape before it is stable.