Update a thing

PATCHhttps://spectra.api.aerovy.com/v2/things/{thingId}

Updates a thing's metadata. Requires an API key with the write action scoped to the thing. Place context is resolved server-side from the thing id.

Loading code example

Loading code example

Authorizations

apiKeystringheaderrequired

API key passed in the header.

thingIdstringrequired

The thing id.

The fields to update.

propertiesobject

Typed properties to set or update (validated against the thing type's schema).

propertiesToDeletearray<string>

Property keys to remove from the device.

attributesobject

Arbitrary user-defined attributes to set or update (merged into the existing set).

attributesToDeletearray<string>

Attribute keys to remove from the device.

thingNamestring

New device name, if changing.

thingDescriptionstring

New description, if changing.

addressstring

New address, if changing.

manufacturerstring

New manufacturer, if changing.

modelstring

New hardware model, if changing.

isFirstPartynull | boolean

Whether the device is first-party; omit to leave unchanged.

thingManufacturerIdstring

New external manufacturer id, if changing (must remain unique within the thing type).

longitudenumber | string<double>

New longitude; 0 leaves it unchanged.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$

latitudenumber | string<double>

New latitude; 0 leaves it unchanged.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$

altitudenumber | string<double>

New altitude in meters; 0 leaves it unchanged.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$

integrationIdsnull | array

Replacement set of integration ids, if changing.

levelIdstring

New level id within the site (site devices only).

application/json

Updated.