Allocate a routed IPv6 prefix to a VPS.

This endpoint allocates a routed IPv6 prefix to a specific virtual server (VPS). You need to provide the VPS ID, which can be retrieved from endpoints like GET /api/vm/{vmid}/status. This is useful when your VPS requires a direct IPv6 connection for network configurations.

Path Parameters

vmid integer · min: 1 required Example

Unique vmid identifier

Headers

Accept Example

Content-Type Example

Body

required

application/json

action string · enum required

allocate

refresh_next_hop

Responses

200

success boolean

timestamp string

requestId string

data object

201

success boolean

timestamp string

requestId string

data object

POST https://cloud.hostup.se/api/vm/{vmid}/routed-ipv6

For AI assistants

cURL

curl -X POST "https://cloud.hostup.se/api/vm/16228/routed-ipv6" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "allocate"
  }'

Response

{
  "success": true,
  "timestamp": "string",
  "requestId": "string",
  "data": {
    "created": true,
    "allocation": {
      "id": 0,
      "rack_id": "string",
      "client_id": "string",
      "account_id": "string",
      "proxmox_vm_id": "string",
      "prefix": "string",
      "prefix_length": 0,
      "next_hop": "string",
      "status": "string",
      "allocated_at": "string",
      "released_at": "string",
      "cooldown_until": "string",
      "metadata": {
        "updatedAt": "string",
        "updatedBy": "string"
      },
      "created_at": "string",
      "updated_at": "string"
    }
  }
}

{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "timestamp": {
      "type": "string"
    },
    "requestId": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "created": {
          "type": "boolean"
        },
        "allocation": {
          "type": "object",
          "properties": {
            "id": {
              "type": "integer"
            },
            "rack_id": {
              "type": "string"
            },
            "client_id": {
              "type": "string"
            },
            "account_id": {
              "type": "string"
            },
            "proxmox_vm_id": {
              "type": "string"
            },
            "prefix": {
              "type": "string"
            },
            "prefix_length": {
              "type": "integer"
            },
            "next_hop": {
              "type": "string"
            },
            "status": {
              "type": "string"
            },
            "allocated_at": {
              "type": "string"
            },
            "released_at": {
              "type": "string",
              "nullable": true
            },
            "cooldown_until": {
              "type": "string",
              "nullable": true
            },
            "metadata": {
              "type": "object",
              "properties": {
                "updatedAt": {
                  "type": "string"
                },
                "updatedBy": {
                  "type": "string"
                }
              }
            },
            "created_at": {
              "type": "string"
            },
            "updated_at": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}

Request Body

{
  "action": "allocate"
}