Skip to main content
DELETE
Release a floating IP

Authorizations

Authorization
string
header
required

Your API key, sent as a bearer token. Create one in the control panel under API Keys, give it only the permissions the integration needs, and copy it when it is created. It cannot be shown again. Each key is restricted to one owned team. The key determines the team for every request.

Path Parameters

floatingIp
string
required

The floating ip uuid short

Example:

"1b8349e5-3568-43e0-bf89-fc3350dd7a08"

Response

The record, as a JSON object. There is no envelope.

A floating IP address and its current assignment.

uuid
string
required

The uuid UUID.

Example:

"1b8349e5-3568-43e0-bf89-fc3350dd7a08"

uuid_short
string
required

The first eight characters of the UUID. Either form can identify the address.

Example:

"1b8349e5"

status
enum<string>
required

The value of status.

Available options:
pending_payment,
active,
pending_cancellation,
deleting,
expired,
cancelled,
payment_review
Example:

"active"

status_label
string
required

The value of status_label.

Example:

"Active"

progress_message
string | null
required

One sentence about why a purchase is waiting, or null.

Example:

null

needs_funds
boolean
required

Whether the purchase is waiting on account credit, which is the one wait the customer can end themselves.

Example:

false

type
enum<string>
required

The type of operation or resource.

Available options:
ipv4,
ipv6
Example:

"ipv4"

address
string | null
required

The IP address, or null after it has been released.

Example:

"198.51.100.42"

cidr
integer | null
required

The network prefix length.

Example:

24

gateway
string | null
required

The gateway address for the network.

Example:

"198.51.100.1"

The value of onlink.

Example:

null

is_primary
boolean
required

Whether the resource is primary.

Example:

false

location
string | null
required

The value of location.

Example:

"Kansas City, MO"

location_id
integer | null
required

The location id ID.

Example:

3

is_granted
boolean
required

Whether the resource is granted.

Example:

false

can_release
boolean
required

Whether the customer can release.

Example:

false

billing
BillingData · object
required

The value of billing.

Example:
can_cancel_checkout
boolean
required

Whether the customer can cancel checkout.

Example:

false

can_request_cancellation
boolean
required

Whether the customer can request cancellation.

Example:

true

can_withdraw_cancellation
boolean
required

Whether the cancellation standing against this address can still be taken back. False for an immediate one, which gave the address away as it was filed.

Example:

false

cancellation_type
enum<string> | null
required

The value of cancellation_type.

Available options:
immediate,
end_of_billing,
null
Example:

null

cancellation_requested_at
string | null
required

The date and time for cancellation requested at, in UTC.

Example:

null

created_at
string | null
required

The date and time for created at, in UTC.

Example:

"2026-06-20T14:03:51+00:00"

server
FloatingIpServerData · object | null
required

Null whenever the address is held but parked on nothing, which is a perfectly ordinary state for a floating address to sit in.

Example:
attaching_to
FloatingIpServerData · object | null
required

The server this address was bought for, while it waits to be put there. It is attached as soon as the purchase has been paid for, and this goes back to null.

Example:

null

attachment_status
enum<string> | null
required

Which way the address is moving while a worker attaches or detaches it, or null once it has settled. An attaching address is not on attaching_to yet; a detaching one is still on server.

Available options:
attaching,
detaching,
null
Example:

null

limits
FloatingIpQuotaSummaryData · object
required

The value of limits.

Example: