Skip to content

Override domain assignment

Request

Overrides a domain's dynamic IP pool assignment. A domain's pool will not be updated by health checks while an override is present.

Security
basicAuth
Path
namestringrequired

The domain name

Bodymultipart/form-datarequired
poolstringrequired

The name of the Dynamic IP pool to override the domain with. Must be a valid pool name (ex: dynamic_good, dynamic_new, etc.)

curl -i -X PUT \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v1/dynamic_pools/domains/{name}/override' \
  -H 'Content-Type: multipart/form-data' \
  -F pool=string

Responses

A 200 response

Bodyapplication/json
property name*objectadditional property
Response
{ "message": "success" }