v12

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1811583196.1 KB
Networking

Release a reserved IP

Release a reserved IP back to the pool.

Billing

For subscription IPs the remaining prepaid balance is refunded pro-rata (hourly precision) to your account balance. For PAYG IPs the IP simply stops accruing further hourly usage — no refund is needed.

The IP must not be attached to a VM. Detach it first via DELETE /api/v1/vms/{id}/ip/{nic_id}.

delete/api/v1/ips/{id}/reserve

Path parameters

idstring uuid required

Floating IP ID (UUID).

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Response

IP released

successboolean
messagestring

Example response

{
  "success": true,
  "message": "Operation completed successfully"
}