Release Dedicated IP
Permanently release a dedicated IP back to the platform's pool. Stops billing for this IP at the end of the current billing cycle. Once released, the IP can be reassigned to another customer; you cannot reclaim it (request a new one if needed).
If the IP is currently attached to an endpoint, the platform automatically detaches it as part of the release. The endpoint reverts to shared anycast — coordinate with consumers whose firewalls might allow-list the dedicated IP, otherwise their requests start failing once DNS propagates.
Path parameters
id int64 Req
Dedicated IP ID from /dedicated-ips.
Request body
None.
Response (204 No Content)
Empty body on success. The IP transitions to status: "releasing" immediately and to "released" after the platform's cleanup completes (usually within a minute).
Errors
401 Unauthorized
Missing auth.
404 Not Found
IP doesn't exist or doesn't belong to the calling user.
409 Conflict
IP is already in
releasing or released state.Request
curl -X POST "https://api.ngris.com/v1/dedicated-ips/7/release" \
-H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris
client = Ngris(api_key="<your_api_key>")
client.dedicated_ips.release("7")
Response — 204 No Content