Description
This function deletes a mail exchanger.
Warning:
We strongly recommend that you use the following UAPI function instead of this function:
-
Email::delete_mx— This function deletes a Mail Exchanger (MX) record.
Examples
https://hostname.example.com:2087/cpsess##########/json-api/cpanel?cpanel_jsonapi_user=user&cpanel_jsonapi_apiversion=2&cpanel_jsonapi_module=Email&cpanel_jsonapi_func=delmx&domain=
$cpanel = new CPANEL(); // Connect to cPanel - only do this once. // Delete the mail.example.com mail exchanger.$delete_mx = $cpanel->api2( 'Email', 'delmx', array( 'domain' => 'example.com', 'exchange' => 'mail.example.com', 'preference' => '5', ) );my $cpliveapi = Cpanel::LiveAPI->new(); # Connect to cPanel - only do this once. # Delete the mail.example.com mail exchanger.my $delete_mx = $cpliveapi->api2( 'Email', 'delmx', { 'domain' => 'example.com', 'exchange' => 'mail.example.com', 'preference' => '5', });Warning:
In cPanel & WHM version 11.30 and later, cPanel tags are deprecated. We strongly recommend that you only use the LiveAPI system to call the cPanel APIs.
cPanel API 2 calls that use cPanel tags vary widely in code syntax and in their output. For more information, read our Deprecated cPanel Tag Usage documentation. Examples are only present in order to help developers move from the old cPanel tag system to our LiveAPI.
cpapi2 --user=username Email delmx domain=example.com exchange=mail.example.com preference=5
{ "cpanelresult": { "apiversion": 2, "func": "delmx", "data": [ { "statusmsg": "Removed entry: example.com. 14400\tIN MX 5 mail.example.com\nBind reloading on server1 using rndc zone: [example.com]\n", "status": 1, "checkmx": { "warnings": [ ], "issecondary": 0, "local": 1, "detected": "local", "remote": 0, "isprimary": 1, "changed": 1, "secondary": 0, "mxcheck": "local" }, "results": "Removed entry: example.com. 14400\tIN MX 5 mail.example.com\nBind reloading on server1 using rndc zone: [example.com]\n" } ], "event": { "result": 1 }, "module": "Email" }}Note:
Use cPanel's API Shell interface (Home >> Advanced >> API Shell) to directly test cPanel API calls.
Parameters
|
Parameter |
Type |
Description |
Possible values |
Example |
|
domain |
string |
Required The mail exchanger's domain. |
A valid domain on the cPanel account. |
example.com |
|
exchange |
string |
Required The mail exchanger name.
|
The mail exchanger's name and domain. |
mail.example.com |
|
preference |
integer |
Required The mail exchanger's priority value. Note: If multiple MX entries match the exchangevalue, the system uses this parameter to find the correct entry. |
A positive integer. |
5 |
Returns
|
Return |
Type |
Description |
Possible values |
Example |
|
statusmsg |
string |
A message of success or a reason for failure. |
|
|
|
status |
Boolean |
Whether the function succeeded. |
|
1 |
|
checkmx |
hash |
A hash of the mail exchanger's data. |
This hash includes the warnings, issecondary,local, detected, remote, isprimary, changed,secondary, and mxcheck returns. |
|
|
warnings |
string |
Warning messages, if any exist. The function returns this value in thecheckmx hash. |
One or more warning messages. |
|
|
issecondary |
Boolean |
Whether the mail exchanger is a secondary exchanger. The function returns this value in thecheckmx hash. |
|
0 |
|
local |
Boolean |
Whether the mail exchanger is a local exchanger. The function returns this value in thecheckmx hash. |
|
0 |
|
detected |
string |
The mail exchanger type. The function returns this value in thecheckmx hash. |
|
auto |
|
remote |
Boolean |
Whether the mail exchanger is a remote exchanger. The function returns this value in thecheckmx hash. |
|
0 |
|
isprimary |
Boolean |
Whether the mail exchanger is the primary mail exchanger. The function returns this value in thecheckmx hash. |
|
0 |
|
changed |
Boolean |
Whether a change occurred during the function. The function returns this value in thecheckmx hash. |
|
1 |
|
secondary |
Boolean |
Whether the mail exchanger is a secondary exchanger. The function returns this value in thecheckmx hash. |
|
0 |
|
mxcheck |
string |
The mail exchanger type. The function returns this value in thecheckmx hash. |
|
auto |
|
results |
string |
A message of success or a reason for failure. |
|
|
|
reason |
string |
A reason for failure. Note: This function only returns areason value if it failed. |
A string that describes the error. |
This is an error message. |
|
result |
Boolean |
Whether the function succeeded. |
|
1 |