How to Pause the Advertisement of a BYOIP Prefix
Validated on 18 Sep 2025 • Last edited on 18 Sep 2025
DigitalOcean Reserved IPs are publicly-accessible static IPv4 and IPv6 addresses. Assign and reassign reserved IP addresses to Droplets as needed, or implement an automated failover mechanism with reserved IPs to build a high availability infrastructure.
You may pause the advertisement of a BYOIP prefix to disable it without deleting it from your team account.
Pause the Advertisement of a BYOIP Prefix using the CLI
To pause the advertisement a prefix, use the doctl network byoip-prefix update
command with the ID of your BYOIP prefix and the flag --advertisement=false
. To find the ID of your prefix, use doctl network byoip-prefix list
to list all of your prefixes and their IDs.
doctl network byoip-prefix update <your_prefix_id> --advertise=false
Replace <your_prefix_id>
with the ID of the prefix you are deprovisioning.
Use the same command with --advertise=true
to resume.
Pause the Advertisement of a BYOIP Prefix using the API
Send a PATCH
request to the /v2/byoip_prefixes/<your_prefix_id>
endpoint with {"advertise": false}
as the request body. To find the ID of your prefix send a GET
request to the /v2/byoip_prefixes
endpoint to list all of your prefixes and their IDs.
curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-d '{"advertise": false}' \
"https://api.digitalocean.com/v2/byoip_prefixes/<your_prefix_id>"
Replace <your_prefix_id>
with the ID of the prefix you are deprovisioning.
The API sends an 202
response with the current state of the BYOIP prefix on success.
Use the same API call with {"advertise": true}
to resume.
Pause the Advertisement of a BYOIP Prefix using the Control Panel
To pause the advertisement of a BYOIP prefix, go to the control panel, in the main menu, click Networking, and then click the Reserved IPs tab.
In the Bring Your Own IP section of the page, find the BYOIP prefix you’d like to pause, click its … context menu, and then click Pause advertisement.
A confirmation window pops up. Type the confirmation text into the text box, and then click Pause advertisement to complete the process.
To resume advertisement of a paused prefix, click Resume advertisement in the prefix’s context menu.