CLI reference / builds / run

stado builds run

Invocation

stado builds run [OPTIONS] --run-id <RUN_ID> <NAME>

Purpose

Enqueue one build job per platform for a recipe now, ignoring the poll cadence

Required inputs and options

Input or optionContract
<NAME>Positional input; required or optional as shown in the invocation.
--run-id <RUN_ID>Caller-retained token; reuse it to recover the same durable run
--jsonEmit the submitted job ids and updated recipe as JSON

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.