PutDedicatedIpInPool method

Moves a dedicated IP address into the specified pool. The folder is selected based on the service account the request originates from.

The same IP address can belong only to one pool at any given time. To delete an IP address from a custom pool, move it to ses-default-dedicated-pool.

The operation is idempotent: moving an IP address to the exact same pool will succeed.

RequestRequest

PUT /v2/email/dedicated-ips/{IP}/pool HTTP/2

Path parametersPath parameters

Request headersRequest headers

Use common request headers in your requests.

Request bodyRequest body

{
  "DestinationPoolName": "<destination_pool_name>"
}

ResponsesResponses

200 OK200 OK

A successful request returns 200 OK in the response.

ErrorsErrors

For all errors, the response body has the same format:

{
   "Code": "<error_name>",
   "message": "<error_description>"
}

The name of the error is taken from its code, e.g., BadRequestException.

The possible errors include:

The system searches for the IP address first, then the pool. If both the IP address and the pool name are invalid, you will get an IP address error.