Manage IP addresses. See device and project endpoints to list and create IP assignments for a particular project or device.

Returns a single ip address if the user has access.

    /ips/{id}
  • Parameters
  • id
    string  (required) in path

    IP Address UUID

    include
    string in query

    related attributes to include

Note! This call can be used to un-assign an IP assignment or delete an IP reservation. Un-assign an IP address record. Use the assignment UUID you get after attaching the IP. This will remove the relationship between an IP and the device and will make the IP address available to be assigned to another device. Delete and IP reservation. Use the reservation UUID you get after adding the IP to the project. This will permanently delete the IP block reservation from the project.

    /ips/{id}
  • Parameters
  • id
    string  (required) in path

    IP Address UUID

Retrieve all ip assignments

GET
/devices/{id}/ips

Returns all ip assignments for a device.

    /devices/{id}/ips
  • Parameters
  • id
    string  (required) in path

    Device UUID

    include
    string in query

    related attributes to include

Create a ip assignment

/devices/{id}/ips

Creates an ip assignment for a device.

    /devices/{id}/ips
  • Parameters
  • id
    string  (required) in path

    Device UUID

    ip_assignment
     (required) in body

    IPAssignment to create

    address

    {
    	"address": "string",
    	"manageable": "boolean",
    	"customdata": "string"
    } 

Provides a list of IP resevations for a single project.

    /ips/{id}/available
  • Parameters
  • id
    string  (required) in path

    IP Reservation UUID

    cidr
    string  (required) in query

    Size of subnets in bits

Retrieve all ip reservations

GET
/projects/{id}/ips

Provides a list of IP resevations for a single project.

    /projects/{id}/ips
  • Parameters
  • id
    string  (required) in path

    Project UUID

    include
    string in query

    related attributes to include

Requesting ip reservations

/projects/{id}/ips

Request more IP space for a project in order to have additional IP addresses to assign to devices. If the request is within the max quota, ip reservation will be created, else, the request will be submitted.

    /projects/{id}/ips
  • Parameters
  • id
    string  (required) in path

    Project UUID

    ip_reservation_request
     (required) in body

    IP Reservation Request to create

    type, quantity

    {
    	"type": "string",
    	"quantity": "integer",
    	"comments": "string",
    	"facility": "string",
    	"customdata": "string",
    	"tags": [
    		"string"
    	]
    } 

Provides the custom metadata stored for this IP Reservation or IP Assignment in json format

    /ips/{id}/customdata
  • Parameters
  • project_id
    string  (required) in path

    Project UUID

    id
    string  (required) in path

    Ip Reservation UUID