Errors

A failure names its class (code) and its reason; a warning, its reason. The class says what to do - correct the input, ask a person, wait, check the state; the reason says what happened, and its params the values. A client that does not know a reason acts on the class.

The input is wrong. Correct it and call again; the same call fails again.

ReasonMeaning
already_existsThe value names something that exists already, and there is only one of it - an address, a name.Reserved
apex_ns_not_allowedThe NS records of the domain itself are the provider's - neither added nor removed.
approval_token_invalidThe approval_token is none this call can use: unknown, expired, used already, or given for another call or other input. Nothing was done. Call again without it, to be asked for the approval anew - never with the arguments changed to fit the token. Its pointer is /approval_token.Reserved
batch_not_acceptedMore than one message in one request; one message per request is taken.Reserved
body_not_jsonThe body of the request is not a JSON document.Reserved
body_too_largeThe body of the request is larger than the server takes.Reserved
caa_invalidA CAA record is not flags, a tag and a value.
class_unsupportedThe zone text cannot be read at the line named; the message says why.
cname_at_apexA CNAME cannot stand at the domain itself, beside its SOA and NS.
cname_not_aloneA CNAME stands alone at its name - no other record beside it.
cname_single_valueA CNAME has one value.
credential_ambiguousMore than one credential arrived; exactly one is taken.Reserved
directive_invalidThe zone text cannot be read at the line named; the message says why.
directive_not_allowedThe zone text cannot be read at the line named; the message says why.
ds_digest_invalidThe zone text cannot be read at the line named; the message says why.
ds_digest_type_unknownThe zone text cannot be read at the line named; the message says why.
ds_invalidThe zone text cannot be read at the line named; the message says why.
duplicateThe list has a value more than once; the pointer is at its second place.Reserved
escape_invalidThe zone text cannot be read at the line named; the message says why.
fields_invalidFields of the input are wrong - each, with its reason, in violations.Reserved
header_repeatedA header that is taken once arrived with more than one value.Reserved
host_invalidThe host is no DNS name.
invalidThe value is not of the type or form the field takes.Reserved
ipv4_address_invalidAn A record holds no IPv4 address.
ipv6_address_invalidAn AAAA record holds no IPv6 address.
job_token_malformedThe job_token is none - pass it as the starting tool answered it.
media_type_not_acceptedThe body is sent in a media type the server does not take.Reserved
method_not_allowedThe address does not take this method.Reserved
mutually_exclusiveThe field cannot stand together with another field of the input - one of them, not both.Reserved
name_needs_final_dotA name written with the domain at its end needs a final dot - or none of the domain.
not_allowedThe value is none of those the field takes.Reserved
not_for_typeThe field does not apply to the type of what the call is about.Reserved
not_foundThe value names something that does not exist - what the input refers to. What the call itself is about, when it does not exist, is the class NOT_FOUND with a reason of the backend's own.Reserved
ns_target_is_providerA subdomain delegated to manitu's own name servers, which hold the zone already.
origin_invalidThe zone text cannot be read at the line named; the message says why.
origin_unsupported_for_typeThe zone text cannot be read at the line named; the message says why.
owner_invalidThe zone text cannot be read at the line named; the message says why.
owner_missingThe zone text cannot be read at the line named; the message says why.
owner_outside_zoneThe zone text cannot be read at the line named; the message says why.
parameter_conflictA parameter arrived in a header and in the body, with two different values.Reserved
parenthesis_unbalancedThe zone text cannot be read at the line named; the message says why.
port_out_of_rangeA port is outside 0 to 65535.
priority_out_of_rangeA priority is outside 0 to 65535.
rdata_missingThe zone text cannot be read at the line named; the message says why.
record_invalidThe zone text cannot be read at the line named; the message says why.
requiredA value is required here and is missing.Reserved
self_referenceThe value refers to the very thing the call is about - a forward to its own address, a record that points to itself.Reserved
soa_invalidThe zone text cannot be read at the line named; the message says why.
soa_missingThe zone text cannot be read at the line named; the message says why.
string_unterminatedThe zone text cannot be read at the line named; the message says why.
svcb_params_invalidThe parameters of an HTTPS or SVCB record are not valid.
target_hostname_invalidA target is no host name - no URL, no port, no path.
tlsa_invalidA TLSA record is not usage, selector, matching type and a digest of the right length.
too_fewThe list has fewer entries than the field allows.Reserved
too_largeThe number is larger than the field allows.Reserved
too_longThe text is longer than the field allows.Reserved
too_manyThe list has more entries than the field allows.Reserved
too_shortThe text is shorter than the field allows.Reserved
too_smallThe number is smaller than the field allows.Reserved
ttl_invalidThe zone text cannot be read at the line named; the message says why.
txt_too_longThe zone text cannot be read at the line named; the message says why.
type_invalidThe zone text cannot be read at the line named; the message says why.
type_unknownA record type no zone can hold.
unknown_fieldThe input has a field the operation does not take.Reserved
unknown_invalidThe zone text cannot be read at the line named; the message says why.
value_invalidThe value is not one of the type.
weight_out_of_rangeA weight is outside 0 to 65535.
wildcard_ns_not_allowedNS records delegate one name, never a wildcard.
zone_not_loadableThe name server would not load the zone; the old zone stays.
zone_text_unreadableThe zone text cannot be read at the line named; the message says why.

The credential is valid, but may not do this. Another credential, or a wider one, is the way - not a repeat.

ReasonMeaning
approval_unavailableThe call needs a level of approval this backend cannot get for this caller - it has no way open for it: no user interface of its own, no kept calls, or not for this credential. Nothing was done, and calling again does not change that: a person does it in the backend's own user interface, or with another credential.Reserved
credential_type_not_allowedThis kind of credential is not taken for this call, or not this way.Reserved
insufficient_scopeThe credential does not carry the scopes the call needs.Reserved
permission_missingThis access lacks a permission the call needs; the main access of the account can grant it.
primary_access_requiredOnly the main access of the account may see this job.

What the call names does not exist, or not for this caller.

ReasonMeaning
operation_unknownNo operation answers at this address.Reserved
resource_not_foundWhat the call names does not exist in the account, or not for this access.

The current state rules the call out. It may work once the state has changed; at once, the same call fails again.

ReasonMeaning
approval_not_pendingIt no longer waits for an approval - it was decided, carried out or has expired.
approval_requiredThe call needs an approval it does not have yet, said in params.approval. Without pending_action nothing was done: show every element as it is, and give the approval the way params.approval.ways says - with call_again, the same call again with the token, after an explicit yes of the person. With pending_action the backend has kept the call and carries it out once a person approves it in its own user interface, which the model cannot reach; the operation that follows a kept call says how it ended.Reserved
approval_staleThe approval was given for a state that has changed since: what the call is about was changed in between, so the call was not carried out. Nothing was done. Do not call again with corrected arguments - look at the state again, and where the call is still wanted, have it approved anew.Reserved
consent_requiredDeprecated: a consent of the person is needed before the call can go through - show every entry of consent_list as it is, and call again with consent_token after an explicit yes. Superseded by approval_required: still read, for a backend that has not moved yet, and removed in a later release; a backend sends approval_required.Reserved
limit_reachedA limit is reached: no more of something until there are fewer, the window has passed, or the limit is raised.Reserved
no_changeThe call would change nothing: what it sets is so already.Reserved
no_webhosting_packageThe defaults of a web hosting package need the domain in one.
not_in_planWhat the call needs is not part of the plan - another plan has it. Something the plan counts is a limit_reached with count_max 0.Reserved
resource_busySomething is still running for what the call is about; the call works once it has finished.Reserved
zone_changedThe zone changed since it was read: read it again and apply the change again.
zone_not_editableThe domain is not active, so its zone cannot be changed.
zone_not_hosted_hereThe zone of the domain is not a primary zone held here - its name servers are elsewhere.
zone_stored_not_readableThe zone as stored cannot be read; the provider has to repair it.

A system the call depends on did not answer. Nothing was done; calling again later may work.

ReasonMeaning
credential_unverifiableThe system that verifies credentials did not answer; the credential itself was not judged.Reserved

The call failed on the server's side, and whether something took effect is not known. Check the state before calling again.

ReasonMeaning
internal_errorSomething unexpected went wrong on the server's side; the log has it under the request id.Reserved
outcome_unknownThe call was sent and broke off before an answer to go by came back - a timeout, a connection that broke, an answer that could not be trusted or read. It may have taken effect: check the state before calling again. Said by the application, for a call that changes something; a read that broke off is UPSTREAM_UNAVAILABLE.Reserved

A warning never blocks the call: it comes with a success, a dry run or a failure, and says what probably does not work as meant, or what was changed on the way.

ReasonMeaning
apex_ns_keptNS records of the domain itself sent were not taken - the provider's stay.
comments_removedComments in the zone text are not kept.
invalid_record_keptA record is not valid (code), but stored so already - kept, not refused. Tell the user; it should be repaired or removed.
ipv4_address_not_globalAn IPv4 address that is not reachable on the internet (private, loopback ...).
ipv4_address_not_in_accountAn IPv4 address that is not one of the account's.
ipv6_address_not_globalAn IPv6 address that is not reachable on the internet (link-local, unique local ...).
ipv6_address_not_in_accountAn IPv6 address that is not one of the account's.
mx_missingNo MX record - no mail for the domain is taken.
mx_target_is_mail_client_hostAn MX record names the host for mail programs, which takes no mail from other servers - suggested_target does.
mx_target_without_addressAn MX target within the zone has no A, AAAA or CNAME record.
record_duplicateA record is there twice.
soa_keptThe SOA name server or contact sent were not taken - the provider's stay.