Skip to content

Disconnect a domain

Disconnect an organization's domain and remove its website names. Visitors lose access through those names. Use dry_run: true to preview the affected names.

Parameters

#
domainstringRequired
The connected domain name to remove from your organization.
dry_runboolean
Preview the change without applying it.
organizationstring
Organization name or ID. A credential, named resource or sole membership can select the organization for you.

Returns

#
dataobjectAlways present
An organization's domain connection and setup or disconnection effects. A preview of the requested change.
Show 2 attributesHide attributes
alternative-1object
An organization's domain connection and setup or disconnection effects.
Show 7 attributesHide attributes
disconnectedboolean
Whether the domain connection was removed. May be omitted.
namestringAlways present
Domain whose connection changed.
removedstring[]
Names removed from Computers by disconnecting the domain. May be omitted.
setupobject
Required DNS records and the current check. May be omitted.
Show 16 attributesHide attributes
certificateobject
Certificate check for a configured name whose DNS is correct. May be omitted.
Show 2 attributesHide attributes
messagestringAlways present
An explanation of the certificate check.
statestringAlways present
Whether the certificate is ready or still needs attention.
codestring
First problem that needs correction. May be omitted.
computerstring
Organization's Computer currently using this name. May be omitted.
domainstringAlways present
Registrable domain containing the name.
kindstringAlways present
Whether the check concerns an ordinary name, root domain or wildcard.
messagestring
What to change to make the name work. May be omitted.
namestringAlways present
Full name being checked.
one_click_urlstring
A provider page that can add the required records, when supported. May be omitted.
optionalobject[]
Suggested additional records, such as a root domain's www name. May be omitted.
Show 1 attributeHide attributes
itemsobject
One DNS record needed for routing or ownership proof.
Show 7 attributesHide attributes
foundstring
What DNS returned when it differed from the expected value. May be omitted.
namestringAlways present
DNS name where the record belongs.
one_click_urlstring
DNS provider's page for adding this record, when available. May be omitted.
purposestringAlways present
Whether the record establishes routing or proves ownership.
statestringAlways present
DNS-check result. proxied requires turning off Cloudflare's proxy for this record.
typestringAlways present
DNS record type to create.
valuestringAlways present
Value the record should contain.
proofstring
How ownership was proved, such as a CNAME or TXT record. May be omitted.
providerobject
Detected DNS provider and where to edit its records. May be omitted.
Show 4 attributesHide attributes
idstringAlways present
Provider identifier.
namestringAlways present
Provider's display name.
records_urlstring
Provider page for editing DNS records. May be omitted.
root_recordstring
Provider's supported record form for a root domain. May be omitted.
proxiedboolean
Whether Cloudflare's proxy is in front of the name. May be omitted.
recordsobject[] | nullAlways present
Required DNS records and what the check found.
Show 1 attributeHide attributes
itemsobject
One DNS record needed for routing or ownership proof.
Show 7 attributesHide attributes
foundstring
What DNS returned when it differed from the expected value. May be omitted.
namestringAlways present
DNS name where the record belongs.
one_click_urlstring
DNS provider's page for adding this record, when available. May be omitted.
purposestringAlways present
Whether the record establishes routing or proves ownership.
statestringAlways present
DNS-check result. proxied requires turning off Cloudflare's proxy for this record.
typestringAlways present
DNS record type to create.
valuestringAlways present
Value the record should contain.
statestringAlways present
Overall DNS-check result.
targetstringAlways present
Organization's DNS destination.
wholeboolean
Whether the parent domain's DNS already routes this name. May be omitted.
teamstring
Permitted team, when limited to a team. May be omitted.
whostring
Who is permitted to assign names under the domain. May be omitted.
wholebooleanAlways present
Whether DNS directs all names under the domain to the organization.
alternative-2object
A preview of the requested change.
Show 3 attributesHide attributes
changesstring[]
Proposed effects and losses. May be omitted.
dry_runbooleanAlways present
True for a preview; no changes are made.
messagestringAlways present
What the request would do.

Errors

#
CodeStatusWhat happened
invalid400An input is missing or invalid.
unauthenticated401The credential is missing, invalid, expired or revoked.
denied403The caller lacks permission for this action.
not_found404The resource is absent or inaccessible to this caller.
conflict409The request conflicts with the current resource state or an earlier request.
over_capacity409The request exceeds a resource or credential allowance.
access_list_full409The change would exceed the access-list allowance.
payment_required402Payment or credit is required.
rate_limited429The caller's request rate exceeds its limit.
busy429Too much work is in progress to accept this request.
unknown503The outcome is unconfirmed; a change may have happened.
unavailable503The service or requested feature is unavailable.

Notes

#
  • API key permission: domain disconnect.