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.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.