Use the del-list operation to remove mailing lists. Use filters to specify mailing lists by name, ID, site ID, or site name. For information on filters, refer to Available Filters section.
A request XML packet removing a mailing list from Plesk database includes the del-list operation node:
<packet version="1.4.2.0">
<maillist>
<del-list>
...
</del-list>
</maillist>
</packet>
The del-list node is presented by the MaillistDelListInputType type (maillist.xsd
), and its graphical representation is as follows:
maillist.xsd
).Remarks
You can remove mailing lists using different filtering rules in a single packet. Add as many del-list operations as the number of different filtering rules to be applied.
<del-list>
...
</del-list>
...
<del-list>
...
</del-list>
The del-list node of the output XML packet is presented by type MaillistDelOutputType (maillist.xsd
) and structured as follows:
common.xsd
).
This request packet removes mailing list MyMailer.
<packet>
<maillist>
<del-list>
<filter>
<name>MyMailer</name>
</filter>
</del-list>
</maillist>
</packet>
Reponse:
<packet>
<maillist>
<del-list>
<result>
<status>ok</status>
<filter-id>MyMailer</filter-id>
<id>13</id>
</result>
</del-list>
</maillist>
</packet>
If mailing list MyMailer was not found on the server, the response is as follows:
<packet>
<maillist>
<del-list>
<result>
<status>error</status>
<errcode>1013</errcode>
<errtext>Maillist does not exist</errtext>
<filter-id>MyMailer</filter-id>
</result>
</del-list>
</maillist>
</packet>
This request packet removes all mailing lists from site Mysite.com.
<packet>
<maillist>
<del-list>
<filter>
<site-name>Mysite.com</site-name>
</filter>
</del-list>
</maillist>
</packet>
Response:
<packet>
<maillist>
<del-list>
<result>
<status>ok</status>
<filter-id>Mysite.com</filter-id>
<id>13</id>
</result>
<result>
<status>ok</status>
<filter-id>Mysite.com</filter-id>
<id>18</id>
</result>
<result>
<status>ok</status>
<filter-id>Mysite.com</filter-id>
<id>23</id>
</result>
</del-list>
</maillist>
</packet>