Release Dedicated IP Group

POST /v1/dedicated-ips/groups/{id}/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/{id}/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

id int64 Req
Group ID from /dedicated-ips/groups.

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
Invalid group id.
401 Unauthorized
Missing auth.
403 Forbidden
Your role lacks the ips:delete permission, or the group belongs to another tenant.
404 Not Found
Group doesn't exist.
Request
curl -X POST "https://api.ngris.com/v1/dedicated-ips/groups/4/release" \ -H "X-API-KEY: <your_api_key>"
Python
from ngris import Ngris client = Ngris(api_key="<your_api_key>") client._post_raw("/dedicated-ips/groups/4/release", {})
Response — 204 No Content
Iris