# Batch update leafs and nodes

Receives a list of objects that mutate nodes and/or leafs. 

Network nodes (star or mesh) cannot be targeted using a  but only using the . The  key is also not supported by nodes so the input validation will throw. Mutations to node require  and cannot include  or .

We expect leafs in the array to not have , and they must have  and .

Both mutations to nodes or leafs must always have  and  keys.

Order does not matter. The payload can include only leafs or only nodes.

Endpoint: PATCH /devices
Security: Authorization

## Request fields (application/json):

  - `devices` (array)
    Example: [{"mac_address":"e6:c4:19:c7:2e:f1","auto":"0","location":"Kitchen","friendly_name":"Amazon Alexa"},{"mac_address":"c2:8e:01:69:7f:f2","auto":"","location":"Living Room","friendly_name":"Aura Frame"},{"location":"Basement","friendly_name":"Mesh Node","node_id":4},{"mac_address":"c2:8e:01:69:7f:f2","auto":"","location":"Living Room","friendly_name":"Smart TV"}]

  - `devices.mac_address` (string)
    required if item is a leaf

  - `devices.auto` (string)
    cannot be included if device is a node, one of "1", "" or "0"
    Enum: "", "0", "1"

  - `devices.location` (string, required)

  - `devices.friendly_name` (string, required)

  - `devices.node_id` (integer)
    required if the mutation is a node, item cannot include mac_address and auto key.