Get auth code to move a domain away
The auth code that moves a domain from manitu to another provider.
manitu_domain_transfer_out_authcode_get on https://mcp.manitu.de/mcpAnnotations as tools/list sends them
Description for the model
Gets the auth code (EPP or transfer code) that moves a domain from manitu to another provider - the customer gives it to the new provider. Needs the customer's consent: the first call is refused with a conflict consent_required carrying consent_list (the AGB) and a consent_token. Show the customer every item - title with link, in its language (the binding wording) - and ask for an explicit yes; only then make the same call again with consent_token (valid 15 minutes, once). Never agree on the customer's behalf. The code itself is withheld here (secrets_withheld): tell the customer to take it from the customer panel (mein.manitu.de) - he also gets a mail. auto_nack true: at this registry a transfer away is refused unless manitu lets it through - the customer should tell manitu once he started it at the new provider. Refused with a conflict when the domain cannot be moved (not_transferable: not active, or a subdomain).
Arguments
namestringrequiredThe domain name, with international characters or in ASCII.
regeneratebooleantrue: a new code - the old one stops working. Default false.
consent_tokenstringwrite-onlyThe consent_token from the consent_required answer of the same call - only after the customer agreed to everything in its consent_list. Valid 15 minutes, once.
Result structuredContent, checked against the schema
namestringrequiredThe domain, with international characters.
authcodestring | nullrequiredThe auth code - a secret; null where it is withheld (secrets_withheld), or where the registry has none to give.
expires_atstring | nullrequiredUntil when the code is valid; null: no end known.
auto_nackbooleanrequiredtrue: at this registry a transfer away is refused unless manitu lets it through.
secrets_withheldbooleanrequiredThe code is left out here (an answer to an agent).
Authentication
One of X-API-Key, Authorization: Bearer … - never more than one in a request. More
Request body JSON; unknown fields are refused
namestringrequiredThe domain name, with international characters or in ASCII.
regeneratebooleantrue: a new code - the old one stops working. Default false.
consent_tokenstringwrite-onlyThe consent_token from the consent_required answer of the same call - only after the customer agreed to everything in its consent_list. Valid 15 minutes, once.
Response in data; the rest of the body as on every call
namestringrequiredThe domain, with international characters.
authcodestring | nullrequiredThe auth code - a secret; null where it is withheld (secrets_withheld), or where the registry has none to give.
expires_atstring | nullrequiredUntil when the code is valid; null: no end known.
auto_nackbooleanrequiredtrue: at this registry a transfer away is refused unless manitu lets it through.
secrets_withheldbooleanrequiredThe code is left out here (an answer to an agent).
Statuses
200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.