Create and start a container
POST/v1/containers/run
Starts an OCI workload via crun. If the image is not in the local store, the daemon pulls it first.
When stream: true, the response is application/x-ndjson (same PullEvent lines as POST /v1/images/pull if a pull runs, then phase: run with container_id). Otherwise the response is a single JSON RunResponse.
If id is omitted, the server generates one from the image reference.
Request
Responses
- 200
- 400
- 502
- 503
Started (JSON) or pull+run stream (NDJSON when stream is true)
Validation or start error (plain text or NDJSON phase:error when streaming)
Registry or transport error during pull (plain text, or NDJSON when streaming)
Supervisor or image store unavailable