# 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  parameter. It can be
one of the following:
 * a valid IP address: this IP address will be removed from the domain pool.
 * string : the entire domain pool will be removed. As far as the system is
   concerned, such domain will no longer exist.
 * string : 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  or  query parameter must be specified, but not both.

If the special value  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: ,  or a valid IP address.

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

## Query parameters:

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

  - `pool_id` (string)
    Replacement DIPP id.

## Response 200 fields (application/json):

  - `message` (string, required)
    Response message