IP addresses

IP addresses endpoints for your Cloud API integration.

📄️List IP addresses

Includes attached and saved addresses. attachment=unattached selects saved addresses with vm_id=null. Only separately paid IPv4 have their own renewal price and auto-renewal; included primary IPv4 and IPv6 may have null billing fields. Prices are fixed, without markup.

📄️Calculate IPv4 purchase

Buys one extra IPv4 for 30 days and attaches it to this VPS. Fixed price without integration markup or term discount. Its payment term and auto-renewal are independent of the VPS. A VPS can have at most 10 IPv4 including the primary address.

📄️Buy IPv4

📄️Attach saved IPv4

Attaches an available, paid saved IPv4 to a compatible VPS without a new purchase or term change. api_key_id is in query; no JSON body. Check guest_configuration_required: network configuration inside the guest may need updating.

📄️Detach IPv4

Detaches an extra IPv4; the primary address cannot be detached. keep_ip is required in query: true keeps the address with continuing separate billing, false releases it. Check guest_configuration_required and adjust guest networking when required. Unused time is not refunded.

📄️Renew IPv4

Renews a separately paid attached or saved IPv4 for 30 days from max(current time, paid_until). Uses the current fixed monthly price, without markup or discount. Included primary IPv4 and IPv6 cannot be renewed separately. Returns HTTP 200 with a completed order and the new paid_until.

📄️IPv4 auto-renewal

Changes the auto-renewal setting without charging the balance or extending the paid term. The default is false. See the lifecycle guide for renewal timing, duration and pricing.

📄️Release saved IPv4

Permanently releases an unattached saved IPv4. The address must not be assigned to a VPS. No charge or refund is created. The result contains operation_id; HTTP 200 confirms release.