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.
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.