# Start an orchestration run

> Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status 'queued' (a worker then claims it and moves it to 'running') and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/succeeded/failed). Delay and poll waits park the run as 'sleeping' and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state.

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Start an orchestration run"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/api/v1/orchestration-runs"}
  context={"endpoint"}
>
  
</MethodEndpoint>

Creates a new run for the orchestration named by orchestration_id. By default the run executes durably in the background: the response returns immediately with status "queued" (a worker then claims it and moves it to "running") and progress is observed via get-orchestration-run or run lifecycle webhook events (orchestration_runs.started/awaiting_input/succeeded/failed). Delay and poll waits park the run as "sleeping" and are woken by a background scheduler, surviving restarts. Pass wait=true to block until the run reaches a terminal or awaiting_input state.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails>
  
</ParamsDetails>

<RequestSchema
  {...require("./start-orchestration-run.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./start-orchestration-run.StatusCodes.json")}
>
  
</StatusCodes>