deploy.deployments.waitWait until a deployment is live, failed or superseded
Long-poll: returns at a terminal status or after timeoutSec (max 55) with terminal=false. Call it again until terminal. A failed deployment carries its error events.
Request syntax
GET /deploy/api/deployments/{id}/waitPath parameters
idRequiredstring
Constraints: uuid
Query parameters
timeoutSecOptionalnumber
Seconds to wait at most before answering with terminal false; default 55
Constraints: integer, 1-55
Response
200 with `data`: the deployment as get returns it (with `terminal` and `succeeded`), plus `errors` — for a failed deployment its last 20 error events (at, phase, message), otherwise empty.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
idAlwaysstring
Deployment idappIdAlwaysstring
The app deployedorgIdAlwaysstring
Organization the deployment belongs togenerationAlwaysnumber
The app generation this deployment representstriggerAlwaysone of push, manual, rollback
What started itgitCommitShaAlwaysstring, may be null
Commit built; null for an image or compose appimageRefAlwaysstring, may be null
Image run, by digest once built; null for a compose deploymentcomposeDigestAlwaysstring, may be null
sha256 of the compose file pinned to it; null for other builderscomposeImagePinsAlwaysmap, may be null
Compose: service name → image digest, for images whose signature was checked; null: noneenvSnapshotAlwaysarray of object, may be null
The environment when it started (secrets by reference), what a rollback restores; null on older deployments and for a caller without deploy:ManageEnvenvSnapshot[].keyAlwaysstring
Variable nameenvSnapshot[].valueKindAlwaysone of plain, secret
plain or secretenvSnapshot[].plainValueAlwaysstring, may be null
The value of a plain variable; null for a secretenvSnapshot[].kmsSecretIdAlwaysstring, may be null
The Secret bound, for a secret; null for plainstatusAlwaysone of queued, building, pushing, deploying, live, failed, superseded
queued, building, pushing, deploying, live, failed or supersededreleaseCommandAlwaysstring, may be null
Release command pinned when it started; null: nonereleaseStatusAlwaysone of pending, running, succeeded, failed, skipped
Where the release command stands; skipped when there is nonereleaseExitCodeAlwaysnumber, may be null
Exit code of the release command; null until it ranbuildLogRefAlwaysstring, may be null
Unused; always nullbuildExitCodeAlwaysnumber, may be null
Exit code the builder reported; null until it finishederrorMessageAlwaysstring, may be null
Why it failed; null unless failedcreatedByAlwaysstring, may be null
IAM user who started it; null for a push or the platformreasonAlwaysstring, may be null
Why it was started, as the starter said; null: nonestatusHistoryAlwaysarray of object
Every status it passed through, oldest firststatusHistory[].statusAlwaysstring
Status enteredstatusHistory[].atAlwaysstring
WhenbundleKeyAlwaysstring, may be null
Pooled hosting: storage key of the uploaded bundle; null otherwisebundleSha256Alwaysstring, may be null
Pooled hosting: sha256 of the bundlebundleBytesAlwaysnumber, may be null
Pooled hosting: size of the bundle, in bytesbranchAlwaysstring, may be null
Pooled hosting: branch the commit was pushed topreviewAlwaysboolean
Pooled hosting: a preview at its own URL rather than productionhostingSummaryAlwaysobject, may be null
Pooled hosting: what the bundle contains; null until readhostingSummary.kindAlwaysone of static, hybrid, fallback
static: files only; hybrid: some routes need the server; fallback: all dohostingSummary.nextVersionAlwaysstring, may be null
Next.js version of the build; null if unknownhostingSummary.filesAlwaysnumber
Number of files served without the serverhostingSummary.nodeRoutesAlwaysarray of object
Routes the app’s server answershostingSummary.nodeRoutes[].pathAlwaysstring
RoutehostingSummary.nodeRoutes[].reasonAlwaysstring
Why it needs the servercreatedAtAlwaysstring
When it was startedliveAtAlwaysstring, may be null
When it went live; null if it never didterminalAlwaysboolean
Whether it is live, failed or supersededsucceededAlwaysboolean
Whether it is liveerrorsAlwaysarray of object
For a failed deployment its last 20 error events; otherwise emptyerrors[].atAlwaysstring
Whenerrors[].phaseAlwaysstring, may be null
Stage; null if noneerrors[].messageAlwaysstring
What went wrong
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow deploy:DescribeApp on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud deploy deployments wait idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/deployments/id/wait" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_deploy_deployments_wait.