Huddle01 Cloud
Floating ips

Associate floating IP

Associate a floating IP with an instance. The system automatically finds the instance's primary port and binds the floating IP to it.

POST
/floating-ips/{id}/associate

Authorization

ApiKeyAuth
X-API-Key<token>

API key for authentication. Generate from the Huddle01 Cloud dashboard.

In: header

Path Parameters

id*string

Floating IP ID

Query Parameters

region*string

Region code (e.g., eu2, us1)

Header Parameters

Idempotency-Key?string

Unique key to ensure idempotent request handling

Request Body

application/json

instance_id*string

ID of the instance to associate the floating IP with

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://cloud.huddleapis.com/api/v1/floating-ips/string/associate?region=string" \  -H "Content-Type: application/json" \  -d '{    "instance_id": "string"  }'
{
  "floating_ip": {
    "id": "string",
    "floating_ip": "string",
    "status": "string",
    "port_id": "string",
    "fixed_ip": "string",
    "region": {
      "name": "eu2"
    }
  }
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}
{
  "success": false,
  "error": "Invalid request"
}