deploy.hosting.getShow how a pooled app is served: its URLs, deployments and previews, what is served from files and what needs its server, and whether the server runs
Request syntax
GET /deploy/api/apps/{id}/hostingPath parameters
idRequiredstring
Constraints: uuid
Response
200 with `data`: for an app on its own machines only { hosting: "machine" }. For a pooled app: hosting, url, memoryMb, idleSeconds, dataSavedAt and dataBytes, `host` (the pool host’s name and state, or null), `deployments` (each served one with commitSha, branch, production, status, createdAt, urls, summary and its running instance) and `requests` (request counters, or null).
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
hostingWhen present"machine"
The app runs on its own machinesurlWhen presentstring
The app’s production URLmemoryMbWhen presentnumber
Memory reserved for the server while it runs, in MBidleSecondsWhen presentnumber
Seconds without a request before the server stopsdataSavedAtWhen presentstring, may be null
When the data directory was last saved; null if neverdataBytesWhen presentnumber, may be null
Size of the last saved data, in byteshostWhen presentobject, may be null
The shared host the app is placed on; null until placedhost.nameWhen presentstring
Name of the shared hosthost.stateWhen presentone of provisioning, ready, draining, lost
Its statehost.lastReportAtWhen presentstring, may be null
When it last reported; null if neverhost.siteWhen presentboolean
Whether it runs on your own hostsdeploymentsWhen presentarray of object
Every deployment served now: production and previewsdeployments[].idWhen presentstring
Deployment iddeployments[].commitShaWhen presentstring, may be null
Commitdeployments[].branchWhen presentstring, may be null
Branch it was pushed todeployments[].productionWhen presentboolean
Whether it is the production deploymentdeployments[].statusWhen presentone of queued, building, pushing, deploying, live, failed, superseded
live or supersededdeployments[].createdAtWhen presentstring
When it was starteddeployments[].urlsWhen presentarray of string
URLs it is served atdeployments[].summaryWhen presentobject, may be null
Pooled hosting: what the bundle contains; null until readdeployments[].summary.kindWhen presentone of static, hybrid, fallback
static: files only; hybrid: some routes need the server; fallback: all dodeployments[].summary.nextVersionWhen presentstring, may be null
Next.js version of the build; null if unknowndeployments[].summary.filesWhen presentnumber
Number of files served without the serverdeployments[].summary.nodeRoutesWhen presentarray of object
Routes the app’s server answersdeployments[].summary.nodeRoutes[].pathWhen presentstring
Routedeployments[].summary.nodeRoutes[].reasonWhen presentstring
Why it needs the serverdeployments[].instanceWhen presentobject, may be null
Its server on the host; null if nonedeployments[].instance.deploymentWhen presentstring
Deployment it servesdeployments[].instance.appWhen presentstring
Appdeployments[].instance.runningWhen presentboolean
Whether the server runs nowdeployments[].instance.kindWhen presentone of restore, boot, may be null
How it last started: restored from a snapshot or booted; null if not yetdeployments[].instance.startMsWhen presentnumber, may be null
How long the last start took, in msdeployments[].instance.runningSecondsWhen presentnumber, may be null
Seconds it has been running; null when stoppeddeployments[].instance.inflightWhen presentnumber
Requests being answered nowdeployments[].instance.memoryBytesWhen presentnumber, may be null
Memory in use, in bytes; null when stoppeddeployments[].instance.snapshotWhen presentboolean
Whether a snapshot to restore from existsdeployments[].instance.snapshotBytesWhen presentnumber, may be null
Size of the snapshot, in bytesdeployments[].instance.noteWhen presentstring, may be null
Anything worth knowing about it; null if nothingdeployments[].instance.startsWhen presentnumber
Number of bootsdeployments[].instance.restoresWhen presentnumber
Number of restores from a snapshotrequestsWhen presentmap, may be null
Request counters by kind (files, server, redirects, not found, wakes); null if none
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 hosting get idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/apps/id/hosting" \
-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_hosting_get.