Deployment
A single versioned release of a service — its image, pipeline status, and per-phase timestamps (the deploy timeline).
Attributes
DeploymentDtoA single versioned release of a service — its image, pipeline status, and per-phase timestamps (the deploy timeline).
Unique identifier of this deployment.
Identifier of the service this deployment belongs to.
Monotonic version number of the deployment within its service.
Resolved container image reference deployed by this release.
Identifier of the build that produced this image, when built from source.
Git branch this release was built from, when built from a git source.
Resolved commit SHA this release was built from, when built from a git source.
The uploaded build-context archive this release was built from (`koo up`).
Pipeline state, a fixed linear sequence: `queued` = accepted, waiting; `building` = the image builder is running (source builds only); `built` = image built and pushed, awaiting apply; `applied` = the release is applied to the platform — the pipeline is DONE (this is not a health verdict: the service may still be starting or unhealthy — see the service status); `failed` = the build or apply failed (see `errors`); `superseded` = a newer deployment replaced this one before it applied. Image deploys skip the build phases (queued → applied).
Live builder stage caption while `building` (e.g. "cloning", "building") — best-effort display detail; the authoritative build state is `status` + the timestamps.
Fatal pipeline failures (populated when `status` is `failed`).
Non-fatal pipeline notes.
When the deployment was created (= entered `queued`).
When the image build started (source builds only).
When the image finished building and was pushed (source builds only).
When the release was applied to the platform.
When the applied release was first observed running (runtime healthy). Absent while the rollout is still in progress — and for releases that never reached healthy.
When the deployment terminally failed or was superseded.
{ "id": "dep_01example0000000000000000x", "serviceId": "svc_01example0000000000000000x", "version": 3, "image": "example", "buildId": "bld_01example0000000000000000x", "branch": "example", "commit": "example", "archiveRef": "example", "status": "queued", "buildStage": "example", "errors": [ { "message": "example", "at": "2026-01-01T00:00:00.000Z", "stage": "build" } ], "warnings": [ { "message": "example", "at": "2026-01-01T00:00:00.000Z", "stage": "build" } ], "createdAt": "2026-01-01T00:00:00.000Z", "buildStartedAt": "2026-01-01T00:00:00.000Z", "builtAt": "2026-01-01T00:00:00.000Z", "appliedAt": "2026-01-01T00:00:00.000Z", "healthyAt": "2026-01-01T00:00:00.000Z", "finishedAt": "2026-01-01T00:00:00.000Z"}