Skip to content
Mailgun Email API/API Documentation/
/
Edit DIPP

Edit DIPP

Request

The account must have 'DIPPs' feature enabled.

It's not allowed to edit a DIPP inherited from the parent account.

IPs being added to the DIPP must be dedicated ones and belong to the account.

If IPs of the DIPP end up modified, and the DIPP is linked to domains, the domains will be updated asynchronously (after this endpoint returns response).

Returns an error if the passed parameters won't result in any changes.

Security
basicAuth
Path
pool_idstringrequired

Id of the DIPP to edit

Bodymultipart/form-datarequired
add_ipstring

The IP to add to the DIPP (may be specified multiple times)

descriptionstring

The new description for the DIPP

link_domainstring

The ID of the domain link to the DIPP (may be specified multiple times)

namestring

The new short for the DIPP

remove_ipstring

The IP to remove from the DIPP (may be specified multiple times)

unlink_domainstring

The ID of the domain to unlink from the DIPP (may be specified multiple times)

curl -i -X PATCH \
  -u '<username>:<password>' \
  'https://api.mailgun.net/v3/ip_pools/{pool_id}' \
  -H 'Content-Type: multipart/form-data' \
  -F add_ip=string \
  -F description=string \
  -F link_domain=string \
  -F name=string \
  -F remove_ip=string \
  -F unlink_domain=string

Responses

A 200 response

Bodyapplication/json
string(string)
Response
{
  "message": "success"
}