replaceOrgDevices

POST https://{{host}}/api/v1/orgs/:org_id/inventory/replace

It’s a common request we get from the customers. When a AP HW has problem and need a replacement, they would want to copy the existing attributes ([Device Config] of this old AP to the new one. It can be done by providing the MAC of a device that’s currently in the inventory but not assigned.

The Device replaced will become unassigned.

This API also supports replacement of Mist Edges. This API copies device agnostic attributes from old Mist edge to new one. Mist manufactured Mist Edges will be reset to factory settings but will still be in Inventory. Brownfield or VM’s will be deleted from Inventory.

Body Parameters

ParameterTypeDescription
site_idstringthe site_id of the device to be replaced
macstringdevice mac
inventory_macstringmac of the inventory that will be replacing the old one. It has to be claimed and unassigned.
discardlistattributes that you don’t want to copy

Request Body

{"site_id"=>"4ac1dcf4-9d8b-7211-65c4-057819f0862b", "mac"=>"5c5b35000101", "inventory_mac"=>"5c5b35000301"}

HEADERS

KeyDatatypeRequiredDescription
Acceptstring
X-CSRFTokenstring
Content-Typestring