How to Deprovision 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 can deprovision Bring Your Own IP (BYOIP) prefixes with doctl, the DigitalOcean API, or the control panel.

Note
A BYOIP prefix cannot be deprovisioned while it has addresses assigned to Droplets. Unassign all addresses before deprovisioning.

Deprovision a BYOIP Prefix Using the CLI

To deprovision a prefix, use the doctl network byoip-prefix delete command with the ID of your BYOIP prefix. 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 delete <your_prefix_id>

Replace <your_prefix_id> with the ID of the prefix you are deprovisioning.

The command prompts for confirmation before deprovisioning the prefix.

Deprovision a BYOIP Prefix Using the API

Send a DELETE request to the /v2/byoip_prefixes/<your_prefix_id> endpoint. 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 DELETE \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "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 empty 202 response on success.

Deprovision a BYOIP Prefix Using the Control Panel

To deprovision 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 want to delete, click its context menu, and then click Delete from DigitalOcean to open the confirmation window.

In the confirmation window, type the confirmation text into the text box, and then click Delete from DigitalOcean to complete the process.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.