host
/hosts/{hostname} [DELETE]
| API Support | Available since | Last updated | Output |
|---|---|---|---|
| 5.8900 | 6.0000 | xml, json |
Description
Deletes a host.
When a host is deleted it is also removed from the list of internal mail hosts.
The hostname is not case sensitive so (example.org is the same as EXAMPLE.ORG)
You cannot delete a host if it is still referenced by a URI or Group URI
Parameters
No parameters defined.
Permission
This service requires administrator.
Response
If successful, this service always returns the following:
<host-delete/>
Error Handling
| HTTP code | Error condition |
|---|---|
| 404 | If the hostname does not exist |
| 400 | Host is still being used by a URI or group URI and cannot be deleted. |