POST /system/email_servers/{email_server_id}

Updates an existing email server.

Table 1. POST /system/email_servers/{email_server_id} resource details
MIME Type
application/json

Table 2. POST /system/email_servers/{email_server_id} request parameter details
Parameter	Type	Optionality	Data Type	MIME Type	Description
email_server_id	path	Required	Number (Integer)	text/plain	Required - The id of the email server to get.

Table 3. POST /system/email_servers/{email_server_id} request body details
Parameter	Data Type	MIME Type	Description	Sample
email_server_details	Object	application/json	Required - An email server details record that contains the following fields: description - String - Description of the email server. hostname - String - Hostname of the email server. port - Number - Port to connect to the email server with. username - String - User name to authenticate with the email server. password - String - Password to authenticate with the email server. enable_tls - Boolean - Whether to ignore TLS verification errors to the email server.	{ "default": true, "description": "String", "enable_tls": true, "hostname": "String", "password": "String", "port": 42, "username": "String" }

Table 4. POST /system/email_servers/{email_server_id} response codes
HTTP Response Code	Unique Code	Description
200		The email server record was updated.
404	3000	The email server does not exist.
409	3010	An email server with the same hostname, port and username already exists.
422	3001	The hostname cannot be longer than 255 characters.
422	3002	The hostname is an IP address.
422	3003	Port must be bewtween 1 and 65535 inclusive.
422	3004	The username cannot be longer than 255 characters.
422	3005	The password cannot be longer than 255 characters.
422	3006	The description cannot be longer than 255 characters.
422	3007	The default value can only be set to true.
422	3013	The username cannot contain spaces or quotes.
422	3014	Username or password not given while updating either field for email server.
422	3016	null
500	3008	Problem encountered while updating default email server database entry.
500	3009	Problem encountered while attempting to read the default email server from the database.
500	3011	Problem encountered while encrypting email server password.
500	3012	Problem encountered while attempting to read the database.
500	3015	Failed to notify the hosts affected by this update that they should update their email server settings.
500	3017	Failed to update the postfix certificate configuration with new email server settings.

Response Description

The updated server record that contains the following fields:

id - Number - ID of the email server.
description - String - Description of the email server.
hostname - String - Hostname of the email server.
port - Number - Port to connect to the email server with.
username - String - User name to authenticate with the email server.
password - String - Password to authenticate with the email server.
enable_tls - Boolean - Whether to ignore TLS verification errors to the email server.

Response Sample


{
    "default": true,
    "description": "String",
    "enable_tls": true,
    "hostname": "String",
    "id": 42,
    "password": "String",
    "port": 42,
    "username": "String"
}