API: runs

Это содержимое пока не доступно на вашем языке.

`GET /api/v1/runs`

List Runs

§3.3.1 — filtered, paginated run list (default sort createtime:desc).

Parameter	In	Required	Type
`status`	query	no	`object`
`pipeline_id`	query	no	`object`
`entity`	query	no	`object`
`contract`	query	no	`object`
`limit`	query	no	`integer`
`offset`	query	no	`integer`
`sort`	query	no	`string`

`POST /api/v1/runs`

Launch Run

§3.3.2 — validate, create a queued run, stage the fixture, enqueue the job.

`GET /api/v1/runs/pipelines`

List Pipelines

§3.3.8 — every registered pipeline definition.

`GET /api/v1/runs/pipelines/{pipeline_id}`

Get Pipeline Def

§3.3.9 — a single pipeline definition.

Parameter	In	Required	Type
`pipeline_id`	path	yes	`string`

`GET /api/v1/runs/preflight`

Run Preflight

SPEC-084 §2.5 (B) — can this run launch? Returns can_launch + blocking reasons WITHOUT creating a run (saves wasted launches / Nebius budget). Declared before /{run_guid} so the static path wins over the int converter.

Parameter	In	Required	Type
`pipeline_id`	query	yes	`string`
`guid`	query	yes	`integer`
`entity`	query	no	`object`

`GET /api/v1/runs/schedules`

List Schedules

§3.3.1 — every schedule, newest first.

`POST /api/v1/runs/schedules`

Create Schedule

§3.3.2 — create a schedule (validates pipeline + cron; computes next_fire_at).

`DELETE /api/v1/runs/schedules/{schedule_id}`

Delete Schedule

§3.3.5 — delete a schedule (idempotent).

Parameter	In	Required	Type
`schedule_id`	path	yes	`integer`

`GET /api/v1/runs/schedules/{schedule_id}`

Get Schedule

§3.3.3 — a single schedule.

Parameter	In	Required	Type
`schedule_id`	path	yes	`integer`

`PATCH /api/v1/runs/schedules/{schedule_id}`

Update Schedule

§3.3.4 — partial update; a changed cron recomputes next_fire_at.

Parameter	In	Required	Type
`schedule_id`	path	yes	`integer`

`POST /api/v1/runs/schedules/{schedule_id}/fire`

Fire Now

§3.3.6 — fire now (same seam as the tick-loop / an external Cloud Scheduler).

Parameter	In	Required	Type
`schedule_id`	path	yes	`integer`

`GET /api/v1/runs/schedules/{schedule_id}/runs`

Schedule Runs

§3.3.7 — guids of the runs this schedule produced (params.schedule_id).

Parameter	In	Required	Type
`schedule_id`	path	yes	`integer`

`GET /api/v1/runs/{run_guid}`

Get Run

§3.3.3 — run record + its steps + target card + pipeline def.

Parameter	In	Required	Type
`run_guid`	path	yes	`integer`

`POST /api/v1/runs/{run_guid}/cancel`

Cancel Run

§3.3.6 — cancel a queued or running run; idempotent (terminal → 409).

Parameter	In	Required	Type
`run_guid`	path	yes	`integer`

`GET /api/v1/runs/{run_guid}/log`

Get Run Log

§3.3.5 — assembled log; step filters to one step, tail keeps last N.

Parameter	In	Required	Type
`run_guid`	path	yes	`integer`
`step`	query	no	`object`
`tail`	query	no	`object`

`POST /api/v1/runs/{run_guid}/retry`

Retry Run

§3.3.7 — create a new run; from_step resumes from a step snapshot.

Parameter	In	Required	Type
`run_guid`	path	yes	`integer`

`GET /api/v1/runs/{run_guid}/steps`

Get Run Steps

§3.3.4 — the step rows of a run, ordered by seq/attempt.

Parameter	In	Required	Type
`run_guid`	path	yes	`integer`