deploy.apps.routingShow how each hostname of the app resolves right now
Request syntax
GET /deploy/api/apps/{id}/routingPath parameters
idRequiredstring
Constraints: uuid
Response
200 with `data`: one entry per hostname, the default one first, then each custom domain — host, url, kind (default or custom), the hosted zone answering for it, the DNS record it needs, `dns` (state ok, mismatch, missing or unknown, the addresses observed and expected) and `tls` (state and detail).
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
[].hostAlwaysstring
Hostname[].urlAlwaysstring
URL the app answers at[].kindAlwaysone of default, custom
default: the platform name; custom: a domain[].wildcardAlwaysboolean
A *.host domain covering every name one label below[].domainIdAlwaysstring, may be null
The custom domain’s id; null for the default host[].isPrimaryAlwaysboolean
Whether it is the primary domain[].platformManagedAlwaysboolean
True when the platform nameservers answer for it with no action from you[].hostedZoneAlwaysobject, may be null
Your hosted zone that answers for the name; null outside every zone[].hostedZone.zoneIdAlwaysstring
Hosted zone id[].hostedZone.zoneNameAlwaysstring
Zone name[].hostedZone.answersForAppAlwaysboolean
Whether the zone holds a record pointing at the app[].hostedZone.delegationAlwaysobject, may be null
Whether the zone is delegated; null when you may not read the zone[].hostedZone.delegation.statusAlwaysone of delegated, elsewhere, pending
Delegation state[].hostedZone.delegation.detailAlwaysstring
One sentence about it[].hostedZone.delegation.checkedAtAlwaysstring, may be null
When it was last checked; null if never[].requiredRecordAlwaysobject, may be null
The DNS record to create; null when the platform answers for the name[].requiredRecord.typeAlwaysone of A, CNAME, ALIAS
Record type[].requiredRecord.nameAlwaysstring
Record name[].requiredRecord.valueAlwaysstring
Record value[].requiredRecord.noteAlwaysstring
Why this record[].dnsAlwaysobject
DNS, resolved live[].dns.stateAlwaysone of ok, mismatch, missing, unknown
What DNS answers now[].dns.observedAlwaysarray of string
Addresses or CNAME targets DNS returned[].dns.expectedIpAlwaysstring, may be null
Address the name should resolve to; null before the first deployment[].dns.detailAlwaysstring
One sentence about it[].tlsAlwaysobject
The certificate[].tls.stateAlwaysone of active, pending, failed, unavailable, on-demand
Certificate state; on-demand for a wildcard, one per name on first request[].tls.detailAlwaysstring
Why, in one sentence[].tls.reportedAtAlwaysstring, may be null
When the machine last reported on it; null if never
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 apps routing idcurl -X GET "https://console.platform-development.deutschecloud.app/deploy/api/apps/id/routing" \
-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_apps_routing.