API
Get an API keyTry it

Change mail address of a web hosting package

Change the address, targets, aliases or description of one mail address, or a mailbox's password, disk space and suspension.

WWriteIdempotentbetaNeeds service_webhosting
Tool
manitu_webhosting_mail_address_seton https://mcp.manitu.de/mcp
POST
/v1/webhosting/mail/address/seton https://api.manitu.de
Try it
Changes the account. Agents say what will happen and wait for an explicit yes before calling it.

Annotations as tools/list sends them

readOnlyHint falsedestructiveHint falseidempotentHint trueopenWorldHint false

Description for the model

Changes a mail address of a web hosting package of the manitu customer account this connection works in, by site_id and mail_address from manitu_webhosting_mail_address_list. Only the fields given change; the type never does (to make a forward a mailbox, delete it and create it anew - ask first). target_list and alias_list replace the lists there - read them first and give the whole new list. new_mail_address renames it (mail programs then log in with the new address). A new mailbox password only as mailbox.password_hash (bcrypt) - NEVER ask for or pass a plaintext password, it is refused over this connection; otherwise the customer sets it in the customer panel. mailbox.suspended true switches a mailbox off without deleting it. Refused with a conflict when the package cannot be changed now (not_configurable). Tell the customer what will change - every new target, as mail to an outside address leaves the account - and ask for an explicit yes first.

Arguments

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1
mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254
new_mail_addressstring

A new address for it, at a domain of the package and free - a catch-all only at another domain (@other.example).

min length 2max length 254
descriptionstring | null

The customer's description, for his own overview. Left out: unchanged (set) or none (create); null or empty: none.

max length 1024
target_listarray of string

Where mail goes on to - the whole list, it replaces the one there. Forward and catch-all: required, at least one; mailbox: copies besides the mailbox (may be empty); reject and delete: not taken. A catch-all may have one entry "@" and a domain of the package - the same name at that domain. Mail to an address outside manitu leaves the account: name the targets to the customer.

max items 25
alias_listarray of string

Other addresses whose mail ends up here - the whole list, it replaces the one there. Mailbox and forward only.

max items 25
greylistingboolean

Greylisting against spam: mail from an unknown sender is accepted only on its second try, minutes later. Mailbox and forward only. Default when created: true.

mailboxobject

The mailbox - type mailbox only.

mailbox.passwordstringwrite-only

The password a mail program logs in with - customer panel and REST only, refused over MCP: never ask for a password in a chat. Kept as a hash only, never shown again. Only one of password, password_hash. 12 to 72 printable ASCII characters, no space at the start or the end, not listed as leaked (pwnedpasswords.com).

min length 12max length 72pattern ^[\x20-\x7E]+$
mailbox.password_hashstringwrite-only

The password as a hash made by the customer - instead of password. A hash can be attacked offline: only for a strong password. Taken: bcrypt ("$2b$" or "$2y$", cost 10 or more).

max length 128pattern ^\$
mailbox.quota_mbinteger | null

Disk space in MB its mail may take, at most the package's; null or 0: no limit of its own. Default when created: the package's.

min 0
mailbox.suspendedboolean

true switches it off without deleting it: no login, mail to it is refused.

mailbox.alias_login_allowedboolean

Whether a mail program may log in with an alias as well. Default when created: false.

Result structuredContent, checked against the schema

mail_addressstringrequired

The address - what the other mail address tools take. A catch-all is "@" and its domain, e.g. @example.de. Internationalized domains in Unicode.

mail_address_asciistringrequired

The same address as the mail servers have it (internationalized domains in ASCII, xn--).

typestring | nullrequired

What happens to its mail: mailbox - kept, to read with a mail program or webmail; forward - sent on to target_list, nothing kept; catchall - every address of its domain not set up otherwise, sent on to target_list; reject - refused, the sender gets an error; delete - accepted and deleted unread, the sender learns nothing. null: a kind no longer used.

One of mailbox forward catchall reject delete null
descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

target_listarray of string | nullrequired

Where its mail goes on to - for a forward and a catch-all where it goes, for a mailbox copies besides the mailbox. An entry "@other.example" (catch-all only) sends to the same name at that domain. null for reject and delete.

alias_listarray of string | nullrequired

Other addresses whose mail ends up here (mailbox and forward only, else null) - they are not addresses of their own.

greylistingboolean | nullrequired

Greylisting against spam: mail from an unknown sender is accepted only on its second try, minutes later. Mailbox and forward only, else null.

created_atstring | nullrequired

When it was created.

Format date-time
mailboxobject | nullrequired

The mailbox - type mailbox only, else null.

mailbox.quota_mbinteger | nullrequired

Disk space in MB its mail may take; null: no limit of its own (the package's applies).

mailbox.suspendedbooleanrequired

Switched off by the customer: no login, mail to it is refused - kept for later.

mailbox.alias_login_allowedbooleanrequired

A mail program may log in with an alias as well, not only with mail_address.

mailbox.panel_accessbooleanrequired

With its address and password one may log in to the customer panel - for this mailbox only (password, autoreply, filters). Changed in the customer panel only.

mailbox.autoreply_activebooleanrequired

An automatic reply (e.g. out of office) is switched on - manitu_webhosting_mail_address_autoreply_get shows it.

mailbox.password_change_recommendedbooleanrequired

The password is kept in an outdated form - the customer should set a new one.

mailbox.last_login_atstring | nullrequired

Its last login (mail program or webmail), null if never.

Format date-time
mailbox.connectionobjectrequired
mailbox.connection.hoststringrequired

The server a mail program connects to - for receiving (IMAP, POP3) and sending (SMTP) alike. NOT the MX server of the package.

mailbox.connection.usernamestringrequired

The user name to log in with - the full mail address; the password is the mailbox's.

mailbox.connection.method_listarray of objectrequired

The ways to connect, per protocol the one to prefer first - encrypted only, there is no unencrypted way. Receiving: IMAP (mail stays on the server, several devices) or POP3 (mail is fetched); sending: SMTP with login (the same user name and password) - port 587 with STARTTLS where 465 is blocked.

mailbox.connection.method_list[].protocolstringrequired
One of imap pop3 smtp
mailbox.connection.method_list[].portintegerrequired
mailbox.connection.method_list[].securitystringrequired

ssl_tls: encrypted from the start (often "SSL/TLS"); starttls: switched to encryption after connecting ("STARTTLS").

One of ssl_tls starttls
mailbox.connection.method_list[].is_recommendedbooleanrequired

Authentication

One of X-API-Key, Authorization: Bearer … - never more than one in a request. More

Request body JSON; unknown fields are refused

site_idinteger | stringrequired

The site_id from manitu_webhosting_list - never guess one.

pattern ^[1-9][0-9]*$min 1
mail_addressstringrequired

The mail address from manitu_webhosting_mail_address_list, e.g. info@example.de - a catch-all is written "@" and its domain, e.g. @example.de. Never guess one.

min length 2max length 254
new_mail_addressstring

A new address for it, at a domain of the package and free - a catch-all only at another domain (@other.example).

min length 2max length 254
descriptionstring | null

The customer's description, for his own overview. Left out: unchanged (set) or none (create); null or empty: none.

max length 1024
target_listarray of string

Where mail goes on to - the whole list, it replaces the one there. Forward and catch-all: required, at least one; mailbox: copies besides the mailbox (may be empty); reject and delete: not taken. A catch-all may have one entry "@" and a domain of the package - the same name at that domain. Mail to an address outside manitu leaves the account: name the targets to the customer.

max items 25
alias_listarray of string

Other addresses whose mail ends up here - the whole list, it replaces the one there. Mailbox and forward only.

max items 25
greylistingboolean

Greylisting against spam: mail from an unknown sender is accepted only on its second try, minutes later. Mailbox and forward only. Default when created: true.

mailboxobject

The mailbox - type mailbox only.

mailbox.passwordstringwrite-only

The password a mail program logs in with - customer panel and REST only, refused over MCP: never ask for a password in a chat. Kept as a hash only, never shown again. Only one of password, password_hash. 12 to 72 printable ASCII characters, no space at the start or the end, not listed as leaked (pwnedpasswords.com).

min length 12max length 72pattern ^[\x20-\x7E]+$
mailbox.password_hashstringwrite-only

The password as a hash made by the customer - instead of password. A hash can be attacked offline: only for a strong password. Taken: bcrypt ("$2b$" or "$2y$", cost 10 or more).

max length 128pattern ^\$
mailbox.quota_mbinteger | null

Disk space in MB its mail may take, at most the package's; null or 0: no limit of its own. Default when created: the package's.

min 0
mailbox.suspendedboolean

true switches it off without deleting it: no login, mail to it is refused.

mailbox.alias_login_allowedboolean

Whether a mail program may log in with an alias as well. Default when created: false.

Response in data; the rest of the body as on every call

mail_addressstringrequired

The address - what the other mail address tools take. A catch-all is "@" and its domain, e.g. @example.de. Internationalized domains in Unicode.

mail_address_asciistringrequired

The same address as the mail servers have it (internationalized domains in ASCII, xn--).

typestring | nullrequired

What happens to its mail: mailbox - kept, to read with a mail program or webmail; forward - sent on to target_list, nothing kept; catchall - every address of its domain not set up otherwise, sent on to target_list; reject - refused, the sender gets an error; delete - accepted and deleted unread, the sender learns nothing. null: a kind no longer used.

One of mailbox forward catchall reject delete null
descriptionstring | nullrequired

What the customer wrote about it (his description), null if nothing - not its name or user name.

target_listarray of string | nullrequired

Where its mail goes on to - for a forward and a catch-all where it goes, for a mailbox copies besides the mailbox. An entry "@other.example" (catch-all only) sends to the same name at that domain. null for reject and delete.

alias_listarray of string | nullrequired

Other addresses whose mail ends up here (mailbox and forward only, else null) - they are not addresses of their own.

greylistingboolean | nullrequired

Greylisting against spam: mail from an unknown sender is accepted only on its second try, minutes later. Mailbox and forward only, else null.

created_atstring | nullrequired

When it was created.

Format date-time
mailboxobject | nullrequired

The mailbox - type mailbox only, else null.

mailbox.quota_mbinteger | nullrequired

Disk space in MB its mail may take; null: no limit of its own (the package's applies).

mailbox.suspendedbooleanrequired

Switched off by the customer: no login, mail to it is refused - kept for later.

mailbox.alias_login_allowedbooleanrequired

A mail program may log in with an alias as well, not only with mail_address.

mailbox.panel_accessbooleanrequired

With its address and password one may log in to the customer panel - for this mailbox only (password, autoreply, filters). Changed in the customer panel only.

mailbox.autoreply_activebooleanrequired

An automatic reply (e.g. out of office) is switched on - manitu_webhosting_mail_address_autoreply_get shows it.

mailbox.password_change_recommendedbooleanrequired

The password is kept in an outdated form - the customer should set a new one.

mailbox.last_login_atstring | nullrequired

Its last login (mail program or webmail), null if never.

Format date-time
mailbox.connectionobjectrequired
mailbox.connection.hoststringrequired

The server a mail program connects to - for receiving (IMAP, POP3) and sending (SMTP) alike. NOT the MX server of the package.

mailbox.connection.usernamestringrequired

The user name to log in with - the full mail address; the password is the mailbox's.

mailbox.connection.method_listarray of objectrequired

The ways to connect, per protocol the one to prefer first - encrypted only, there is no unencrypted way. Receiving: IMAP (mail stays on the server, several devices) or POP3 (mail is fetched); sending: SMTP with login (the same user name and password) - port 587 with STARTTLS where 465 is blocked.

mailbox.connection.method_list[].protocolstringrequired
One of imap pop3 smtp
mailbox.connection.method_list[].portintegerrequired
mailbox.connection.method_list[].securitystringrequired

ssl_tls: encrypted from the start (often "SSL/TLS"); starttls: switched to encryption after connecting ("STARTTLS").

One of ssl_tls starttls
mailbox.connection.method_list[].is_recommendedbooleanrequired

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.