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
uuid — an item of /dedicated-ips.Deprecated: the legacy integer id is still accepted in the path until the sunset, answered with Deprecation and Sunset headers. Use the uuid.
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
integer_id_unsupported).Assignment not found — unknown uuid, an assignment of another account (this used to be a 403), or an assignment that is already released.