Release Dedicated IP Group

POST /v1/dedicated-ips/groups/{uuid}/release

Release an entire per-region group in one call. This frees every member IP back to the platform's pool, stops their recurring billing immediately, reverts any attached endpoints to the shared target, and deletes the group's GeoDNS record set. Once released, the IPs can be reassigned to other customers; you cannot reclaim them (request a new group if needed).

To release just one IP out of a group instead, use POST /v1/dedicated-ips/{uuid}/release on that member's assignment — the group reconciles its remaining geo set.

Endpoints that were CNAME'd at the group's geo FQDN revert to shared anycast — coordinate with consumers whose firewalls allow-list the dedicated IPs, otherwise their requests start failing once DNS propagates.

Billing: recurring per-IP charges stop immediately. The one-time setup fee charged when the group was provisioned is non-refundable. If the release is the result of a plan downgrade, the IPs are parked in standby reserved for your account for 7 days; a re-upgrade within that window reconstitutes the group (and re-charges the setup fee).

Path parameters

uuid string (uuid) Req
The group's uuid from /dedicated-ips/groups.

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 call is idempotent: releasing a group that is already released also returns 204.

Errors

400 Bad Request
An integer id after the sunset (integer_id_unsupported).
401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks the ips:delete permission.
404 Not Found
Group not found — unknown uuid, or a group of another account (this used to be a 403).
Request
curl -X POST "https://api.ngris.com/v1/dedicated-ips/groups/019b153d-c31b-7b7a-afe6-b67cc62bf94c/release" \ -H "X-API-KEY: <your_api_key>" \ -H "Content-Type: application/json"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") client._post_raw("/dedicated-ips/groups/019b153d-c31b-7b7a-afe6-b67cc62bf94c/release", {})
Response — 204 No Content
Was this helpful?
Was this helpful?