# 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.

## INVALID_INPUT

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

- [`already_exists`](/errors/already_exists.md) (reserved): The value names something that exists already, and there is only one of it - an address, a name.
- [`apex_ns_not_allowed`](/errors/apex_ns_not_allowed.md): The NS records of the domain itself are the provider's - neither added nor removed.
- [`approval_token_invalid`](/errors/approval_token_invalid.md) (reserved): The 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.
- [`batch_not_accepted`](/errors/batch_not_accepted.md) (reserved): More than one message in one request; one message per request is taken.
- [`body_not_json`](/errors/body_not_json.md) (reserved): The body of the request is not a JSON document.
- [`body_too_large`](/errors/body_too_large.md) (reserved): The body of the request is larger than the server takes.
- [`caa_invalid`](/errors/caa_invalid.md): A CAA record is not flags, a tag and a value.
- [`class_unsupported`](/errors/class_unsupported.md): The zone text cannot be read at the line named; the message says why.
- [`cname_at_apex`](/errors/cname_at_apex.md): A CNAME cannot stand at the domain itself, beside its SOA and NS.
- [`cname_not_alone`](/errors/cname_not_alone.md): A CNAME stands alone at its name - no other record beside it.
- [`cname_single_value`](/errors/cname_single_value.md): A CNAME has one value.
- [`credential_ambiguous`](/errors/credential_ambiguous.md) (reserved): More than one credential arrived; exactly one is taken.
- [`directive_invalid`](/errors/directive_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`directive_not_allowed`](/errors/directive_not_allowed.md): The zone text cannot be read at the line named; the message says why.
- [`ds_digest_invalid`](/errors/ds_digest_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`ds_digest_type_unknown`](/errors/ds_digest_type_unknown.md): The zone text cannot be read at the line named; the message says why.
- [`ds_invalid`](/errors/ds_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`duplicate`](/errors/duplicate.md) (reserved): The list has a value more than once; the pointer is at its second place.
- [`escape_invalid`](/errors/escape_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`fields_invalid`](/errors/fields_invalid.md) (reserved): Fields of the input are wrong - each, with its reason, in violations.
- [`header_repeated`](/errors/header_repeated.md) (reserved): A header that is taken once arrived with more than one value.
- [`host_invalid`](/errors/host_invalid.md): The host is no DNS name.
- [`invalid`](/errors/invalid.md) (reserved): The value is not of the type or form the field takes.
- [`ipv4_address_invalid`](/errors/ipv4_address_invalid.md): An A record holds no IPv4 address.
- [`ipv6_address_invalid`](/errors/ipv6_address_invalid.md): An AAAA record holds no IPv6 address.
- [`job_token_malformed`](/errors/job_token_malformed.md): The job_token is none - pass it as the starting tool answered it.
- [`media_type_not_accepted`](/errors/media_type_not_accepted.md) (reserved): The body is sent in a media type the server does not take.
- [`method_not_allowed`](/errors/method_not_allowed.md) (reserved): The address does not take this method.
- [`mutually_exclusive`](/errors/mutually_exclusive.md) (reserved): The field cannot stand together with another field of the input - one of them, not both.
- [`name_needs_final_dot`](/errors/name_needs_final_dot.md): A name written with the domain at its end needs a final dot - or none of the domain.
- [`not_allowed`](/errors/not_allowed.md) (reserved): The value is none of those the field takes.
- [`not_for_type`](/errors/not_for_type.md) (reserved): The field does not apply to the type of what the call is about.
- [`not_found`](/errors/not_found.md) (reserved): The 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.
- [`ns_target_is_provider`](/errors/ns_target_is_provider.md): A subdomain delegated to manitu's own name servers, which hold the zone already.
- [`origin_invalid`](/errors/origin_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`origin_unsupported_for_type`](/errors/origin_unsupported_for_type.md): The zone text cannot be read at the line named; the message says why.
- [`owner_invalid`](/errors/owner_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`owner_missing`](/errors/owner_missing.md): The zone text cannot be read at the line named; the message says why.
- [`owner_outside_zone`](/errors/owner_outside_zone.md): The zone text cannot be read at the line named; the message says why.
- [`parameter_conflict`](/errors/parameter_conflict.md) (reserved): A parameter arrived in a header and in the body, with two different values.
- [`parenthesis_unbalanced`](/errors/parenthesis_unbalanced.md): The zone text cannot be read at the line named; the message says why.
- [`port_out_of_range`](/errors/port_out_of_range.md): A port is outside 0 to 65535.
- [`priority_out_of_range`](/errors/priority_out_of_range.md): A priority is outside 0 to 65535.
- [`rdata_missing`](/errors/rdata_missing.md): The zone text cannot be read at the line named; the message says why.
- [`record_invalid`](/errors/record_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`required`](/errors/required.md) (reserved): A value is required here and is missing.
- [`self_reference`](/errors/self_reference.md) (reserved): The value refers to the very thing the call is about - a forward to its own address, a record that points to itself.
- [`soa_invalid`](/errors/soa_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`soa_missing`](/errors/soa_missing.md): The zone text cannot be read at the line named; the message says why.
- [`string_unterminated`](/errors/string_unterminated.md): The zone text cannot be read at the line named; the message says why.
- [`svcb_params_invalid`](/errors/svcb_params_invalid.md): The parameters of an HTTPS or SVCB record are not valid.
- [`target_hostname_invalid`](/errors/target_hostname_invalid.md): A target is no host name - no URL, no port, no path.
- [`tlsa_invalid`](/errors/tlsa_invalid.md): A TLSA record is not usage, selector, matching type and a digest of the right length.
- [`too_few`](/errors/too_few.md) (reserved): The list has fewer entries than the field allows.
- [`too_large`](/errors/too_large.md) (reserved): The number is larger than the field allows.
- [`too_long`](/errors/too_long.md) (reserved): The text is longer than the field allows.
- [`too_many`](/errors/too_many.md) (reserved): The list has more entries than the field allows.
- [`too_short`](/errors/too_short.md) (reserved): The text is shorter than the field allows.
- [`too_small`](/errors/too_small.md) (reserved): The number is smaller than the field allows.
- [`ttl_invalid`](/errors/ttl_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`txt_too_long`](/errors/txt_too_long.md): The zone text cannot be read at the line named; the message says why.
- [`type_invalid`](/errors/type_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`type_unknown`](/errors/type_unknown.md): A record type no zone can hold.
- [`unknown_field`](/errors/unknown_field.md) (reserved): The input has a field the operation does not take.
- [`unknown_invalid`](/errors/unknown_invalid.md): The zone text cannot be read at the line named; the message says why.
- [`value_invalid`](/errors/value_invalid.md): The value is not one of the type.
- [`weight_out_of_range`](/errors/weight_out_of_range.md): A weight is outside 0 to 65535.
- [`wildcard_ns_not_allowed`](/errors/wildcard_ns_not_allowed.md): NS records delegate one name, never a wildcard.
- [`zone_not_loadable`](/errors/zone_not_loadable.md): The name server would not load the zone; the old zone stays.
- [`zone_text_unreadable`](/errors/zone_text_unreadable.md): The zone text cannot be read at the line named; the message says why.

## PERMISSION_DENIED

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

- [`approval_unavailable`](/errors/approval_unavailable.md) (reserved): The 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.
- [`credential_type_not_allowed`](/errors/credential_type_not_allowed.md) (reserved): This kind of credential is not taken for this call, or not this way.
- [`insufficient_scope`](/errors/insufficient_scope.md) (reserved): The credential does not carry the scopes the call needs.
- [`permission_missing`](/errors/permission_missing.md): This access lacks a permission the call needs; the main access of the account can grant it.
- [`primary_access_required`](/errors/primary_access_required.md): Only the main access of the account may see this job.

## NOT_FOUND

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

- [`operation_unknown`](/errors/operation_unknown.md) (reserved): No operation answers at this address.
- [`resource_not_found`](/errors/resource_not_found.md): What the call names does not exist in the account, or not for this access.

## PRECONDITION_FAILED

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

- [`approval_not_pending`](/errors/approval_not_pending.md): It no longer waits for an approval - it was decided, carried out or has expired.
- [`approval_required`](/errors/approval_required.md) (reserved): The 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.
- [`approval_stale`](/errors/approval_stale.md) (reserved): The 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.
- [`consent_required`](/errors/consent_required.md) (reserved): Deprecated: 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.
- [`limit_reached`](/errors/limit_reached.md) (reserved): A limit is reached: no more of something until there are fewer, the window has passed, or the limit is raised.
- [`no_change`](/errors/no_change.md) (reserved): The call would change nothing: what it sets is so already.
- [`no_webhosting_package`](/errors/no_webhosting_package.md): The defaults of a web hosting package need the domain in one.
- [`not_in_plan`](/errors/not_in_plan.md) (reserved): What 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.
- [`resource_busy`](/errors/resource_busy.md) (reserved): Something is still running for what the call is about; the call works once it has finished.
- [`zone_changed`](/errors/zone_changed.md): The zone changed since it was read: read it again and apply the change again.
- [`zone_not_editable`](/errors/zone_not_editable.md): The domain is not active, so its zone cannot be changed.
- [`zone_not_hosted_here`](/errors/zone_not_hosted_here.md): The zone of the domain is not a primary zone held here - its name servers are elsewhere.
- [`zone_stored_not_readable`](/errors/zone_stored_not_readable.md): The zone as stored cannot be read; the provider has to repair it.

## UPSTREAM_UNAVAILABLE

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

- [`credential_unverifiable`](/errors/credential_unverifiable.md) (reserved): The system that verifies credentials did not answer; the credential itself was not judged.

## OPERATION_FAILED

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

- [`internal_error`](/errors/internal_error.md) (reserved): Something unexpected went wrong on the server's side; the log has it under the request id.
- [`outcome_unknown`](/errors/outcome_unknown.md) (reserved): The 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.

## Warnings

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.

- [`apex_ns_kept`](/errors/apex_ns_kept.md): NS records of the domain itself sent were not taken - the provider's stay.
- [`comments_removed`](/errors/comments_removed.md): Comments in the zone text are not kept.
- [`invalid_record_kept`](/errors/invalid_record_kept.md): A record is not valid (code), but stored so already - kept, not refused. Tell the user; it should be repaired or removed.
- [`ipv4_address_not_global`](/errors/ipv4_address_not_global.md): An IPv4 address that is not reachable on the internet (private, loopback ...).
- [`ipv4_address_not_in_account`](/errors/ipv4_address_not_in_account.md): An IPv4 address that is not one of the account's.
- [`ipv6_address_not_global`](/errors/ipv6_address_not_global.md): An IPv6 address that is not reachable on the internet (link-local, unique local ...).
- [`ipv6_address_not_in_account`](/errors/ipv6_address_not_in_account.md): An IPv6 address that is not one of the account's.
- [`mx_missing`](/errors/mx_missing.md): No MX record - no mail for the domain is taken.
- [`mx_target_is_mail_client_host`](/errors/mx_target_is_mail_client_host.md): An MX record names the host for mail programs, which takes no mail from other servers - suggested_target does.
- [`mx_target_without_address`](/errors/mx_target_without_address.md): An MX target within the zone has no A, AAAA or CNAME record.
- [`record_duplicate`](/errors/record_duplicate.md): A record is there twice.
- [`soa_kept`](/errors/soa_kept.md): The SOA name server or contact sent were not taken - the provider's stay.
