Get default DNS config for an organization

Retrieves the default DNS configuration for the specified organization. If the organization has its own default DNS config, it is returned directly. If not, the config is resolved by walking up the organization hierarchy (inheritance). When the config is inherited from a parent organization, the response includes the `inherited_from_organisation_id` field. The `dns_id` references a DNS configuration object that can be retrieved or created via the [`/api/v1/dns`](/developers/api/service-lookups-and-configuration/dns-get) endpoints.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the POST request to /api/v1/authenticate.

Path parameters

organisation_idlongRequired
Organization ID

Response

Default DNS configuration retrieved successfully.
organisation_idlong
The organization ID for which the default DNS was requested.
dns_idinteger

ID of the DNS configuration object. Refers to a DNS config from /api/v1/dns.

allow_overwriteboolean
Whether child organizations are allowed to set their own default DNS config.
dnsobject
The resolved DNS configuration details.
inherited_from_organisation_idlong
Present only when the config is inherited from a parent organization. Indicates the source organization ID.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error