Read DNS guidance
domainGuidanceRead the DNS picture behind ONE connected hostname — the Domains page’s provider guidance. It takes a connection’s domainId, never a hostname; another project’s connection answers exactly as the dashboard does. lookup: not_read (reason: routing_unconfirmed) means Tofu has not queried public DNS because the routing setting is unconfirmed: its message explains that unobserved state, with no conclusion about missing records or propagation. Otherwise it reports the nameservers a fixed public resolver returned, their provider’s ordered steps, the reported pitfalls and conflicts (records that would fight the one Tofu asks for). root.support: no means this app cannot use a domain’s root on any DNS host; root.www connects instead, with the root forwarding to it at the domain registrar. It is what Tofu saw, the page’s own read, not a diagnosis. It writes no DNS and returns no credential.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>",
"domainId": "<domainId>"
},
"name": "domainGuidance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domainId | Yes | ||
| projectId | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| root | No | ||
| zone | No | ||
| steps | No | ||
| lookup | Yes | ||
| reason | No | ||
| message | Yes | ||
| existing | No | ||
| hostname | Yes | ||
| pitfalls | No | ||
| provider | No | ||
| resolver | No | ||
| checkedAt | No | ||
| conflicts | No | ||
| cnameTarget | No | ||
| nameservers | No | ||
| domainConnect | No | ||
| providerLabel | No | ||
| negativeCacheMinutes | No |