# Remove an IP from the domain pool, unlink a DIPP or remove the domain pool

The behavior of the endpoint depends on the value of the ip parameter. It can be
one of the following:
 * a valid IP address: this IP address will be removed from the domain pool.
 * string all: the entire domain pool will be removed. As far as the system is
   concerned, such domain will no longer exist.
 * string ip_pool: the DIPP which is currently linked to the domain will be
   unlinked.

### Removing An IP
Note that it's impossible to alter domain IPs if a DIPP is linked to the domain.

If the account is not eligible for shared IPs, additional rules apply:
 * removing the last IP from the domain is not allowed;
 * if all of the remaining dedicated IPs are on warmup, an extra IP might be added to
   the domain pool.

### Unlinking The DIPP
The account must have 'DIPPs' feature enabled.

Either ip or pool_id query parameter must be specified, but not both.

If the special value shared is used for the replacement IP, the account must be
eligible for shared IPs. In this case the system will assign a shared IP as the
replacement.

Endpoint: DELETE /v3/domains/{name}/ips/{ip}
Version: 3.0.0
Security: basicAuth

## Path parameters:

  - `ip` (string, required)
    One of the following: all, ip_pool or a valid IP address.

  - `name` (string, required)
    Domain name. Converted to X-Mailgun-Domain-Id header by the middleware.

## Query parameters:

  - `ip` (string)
    Replacement IP or special value shared.

  - `pool_id` (string)
    Replacement DIPP id.

## Response 200 fields (application/json):

  - `message` (string, required)
    Response message