deploy.deployments.listList the deployments of an app, newest first
Request syntax
GET /deploy/api/apps/{id}/deploymentsPath parameters
idRequiredstring
Constraints: uuid
Response
200 with `data`: the last 50 deployments, newest first — id, generation, trigger, status, gitCommitSha, imageRef, composeDigest, envSnapshot, releaseStatus, errorMessage, reason, createdBy, statusHistory, createdAt and liveAt. The pinned compose file text is left out.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
[].idAlwaysstring
Deployment id[].appIdAlwaysstring
The app deployed[].orgIdAlwaysstring
Organization the deployment belongs to[].generationAlwaysnumber
The app generation this deployment represents[].triggerAlwaysone of push, manual, rollback
What started it[].gitCommitShaAlwaysstring, may be null
Commit built; null for an image or compose app[].imageRefAlwaysstring, may be null
Image run, by digest once built; null for a compose deployment[].composeDigestAlwaysstring, may be null
sha256 of the compose file pinned to it; null for other builders[].composeImagePinsAlwaysmap, may be null
Compose: service name → image digest, for images whose signature was checked; null: none[].envSnapshotAlwaysarray 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:ManageEnv[].envSnapshot[].keyAlwaysstring
Variable name[].envSnapshot[].valueKindAlwaysone of plain, secret
plain or secret[].envSnapshot[].plainValueAlwaysstring, may be null
The value of a plain variable; null for a secret[].envSnapshot[].kmsSecretIdAlwaysstring, may be null
The Secret bound, for a secret; null for plain[].statusAlwaysone of queued, building, pushing, deploying, live, failed, superseded
queued, building, pushing, deploying, live, failed or superseded[].releaseCommandAlwaysstring, may be null
Release command pinned when it started; null: none[].releaseStatusAlwaysone of pending, running, succeeded, failed, skipped
Where the release command stands; skipped when there is none[].releaseExitCodeAlwaysnumber, may be null
Exit code of the release command; null until it ran[].buildLogRefAlwaysstring, may be null
Unused; always null[].buildExitCodeAlwaysnumber, may be null
Exit code the builder reported; null until it finished[].errorMessageAlwaysstring, may be null
Why it failed; null unless failed[].createdByAlwaysstring, may be null
IAM user who started it; null for a push or the platform[].reasonAlwaysstring, may be null
Why it was started, as the starter said; null: none[].statusHistoryAlwaysarray of object
Every status it passed through, oldest first[].statusHistory[].statusAlwaysstring
Status entered[].statusHistory[].atAlwaysstring
When[].bundleKeyAlwaysstring, may be null
Pooled hosting: storage key of the uploaded bundle; null otherwise[].bundleSha256Alwaysstring, may be null
Pooled hosting: sha256 of the bundle[].bundleBytesAlwaysnumber, may be null
Pooled hosting: size of the bundle, in bytes[].branchAlwaysstring, may be null
Pooled hosting: branch the commit was pushed to[].previewAlwaysboolean
Pooled hosting: a preview at its own URL rather than production[].hostingSummaryAlwaysobject, may be null
Pooled hosting: what the bundle contains; null until read[].hostingSummary.kindAlwaysone of static, hybrid, fallback
static: files only; hybrid: some routes need the server; fallback: all do[].hostingSummary.nextVersionAlwaysstring, may be null
Next.js version of the build; null if unknown[].hostingSummary.filesAlwaysnumber
Number of files served without the server[].hostingSummary.nodeRoutesAlwaysarray of object
Routes the app’s server answers[].hostingSummary.nodeRoutes[].pathAlwaysstring
Route[].hostingSummary.nodeRoutes[].reasonAlwaysstring
Why it needs the server[].createdAtAlwaysstring
When it was started[].liveAtAlwaysstring, may be null
When it went live; null if it never did
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 list idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/apps/id/deployments" \
-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_list.