provisionInstallerDevices

PUT https://{{host}}/api/v1/installer/orgs/:org_id/devices/:mac

If replacing_mac is in the request payload, other attributes are ignored, we attempt to replace existing device (with mac replacing_mac) with the inventory device being configured. The replacement device must be in the inventory but not assigned, and the replacing_mac device must be assigned to a site, and satisfy grace period requirements. The Device replaced will become unassigned.

Body Parameters

ParameterTypeDescription
namestringRequired. Device Name
deviceprofile_namestringOptional.
site_idstringOptional
site_namestringOptional
map_idstringOptional
xnumberOptional
ynumberOptional
heightnumberOptional
orientationnumberOptional

Request Body

{"name"=>"SJ1-AP1", "deviceprofile_name"=>"SJ1", "site_id"=>"4ac1dcf4-9d8b-7211-65c4-057819f0862b", "site_name"=>"SJ1", "map_id"=>"845a23bf-bed9-e43c-4c86-6fa474be7ae5", "x"=>150, "y"=>300, "height"=>2.7, "orientation"=>90, "role"=>"switch_role", "replacing_mac"=>"5c5b3500003"}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
X-CSRFTokenstring
Content-Typestring

RESPONSES

status: OK