Create a thing in a site

POSThttps://spectra.api.aerovy.com/v2/sites/{placeId}/things

Creates a thing in a site. Requires an API key with the write action scoped to the site.

Loading code example

Loading code example

Authorizations

apiKeystringheaderrequired

API key passed in the header.

Path Parameters

placeIdstringrequired

The site id to create the thing in.

Body

The thing to create.

thingNamestringrequired

Human-readable name for the device.

Length: >= 1, <= 256

thingTypenull | string

Thing-type display name (e.g. "EV Charger"). Provide this OR string? CreateThingRequest.ThingTypeId (or both, in which case they must match).

thingTypeIdnull | string

Thing-type index id (e.g. `tdefi_…`). Provide this OR string? CreateThingRequest.ThingType.

thingDescriptionstring

Optional free-text description of the device.

addressstring

Optional postal/physical address of the device.

modelstring

Hardware model identifier.

manufacturerstring

Hardware manufacturer.

isFirstPartyboolean

Whether this is a first-party (Aerovy-supported) device.

thingManufacturerIdstring

External manufacturer-assigned id for the device (must be unique within the thing type).

isSimulatedboolean

Whether the device is simulated (synthetic data) rather than physical.

longitudenull | number | string<double>

Optional longitude of the device's location.

Required range: x >= -180, x <= 180

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

latitudenull | number | string<double>

Optional latitude of the device's location.

Required range: x >= -90, x <= 90

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

altitudenull | number | string<double>

Optional altitude of the device's location, in meters.

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

levelIdnull | string

Optional level id within a site (ignored for fleet devices).

attributesobject

Arbitrary user-defined key/value metadata for the device.

propertiesobject

Typed properties predefined by the device's thing type (validated against its schema).

Response

application/json

Created.