advertise: true) to make it fully usable and accessible from the internet.
How to Pause or Resume BYOIP Prefix Advertisement
Validated on 18 Sep 2025 • Last edited on 13 Nov 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. You can also resume advertisement to make a paused or newly provisioned prefix accessible from the internet.
Pause the Advertisement of a BYOIP Prefix
Using the CLI
To pause the advertisement of 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=falseReplace <your_prefix_id> with the ID of the prefix you are pausing.
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 pausing.
The API sends a 202 response with the current state of the BYOIP prefix on success.
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.
Resume the Advertisement of a BYOIP Prefix
Using the CLI
To resume the advertisement of a paused or newly provisioned prefix, use the doctl network byoip-prefix update command with the ID of your BYOIP prefix and the flag --advertise=true. 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=trueReplace <your_prefix_id> with the ID of the prefix you are resuming.
Using the API
Send a PATCH request to the /v2/byoip_prefixes/<your_prefix_id> endpoint with {"advertise": true} 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": true}' \
"https://api.digitalocean.com/v2/byoip_prefixes/<your_prefix_id>"Replace <your_prefix_id> with the ID of the prefix you are resuming.
The API sends a 202 response with the current state of the BYOIP prefix on success.
Using the Control Panel
To resume advertisement of a paused or newly provisioned 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 resume and click Resume advertisement.