slControl API

LogoutChangelog (26.08.2024)Legal notesBasic usageRequest EmulatorTroubleshooting
Global
Get list of accessible customersGet lookup tables for settingsGet lookup tables for devicesGet lookup tables for operationModeGet lookup tables for gatewaysGet lookup tables for jobsGet lookup tables for alerts
Customers
Get customer configurationUpdate customer configurationGet mesh network
Groups
Get group tree
Lamp switches
Get lamp switchesUpdate lamp switches
Luminaire points
Get luminaire pointsUpdate luminaire pointsCreate luminaire pointsDelete luminaire points
Devices
Get devicesGet device dataGet device stateUpdate device dataUpdate device operation stateGet operation modeUpdate operation modeDelete deviceDelete devices
Devices - Statistics/Logs
Get radar dataGet motion dataGet device energyGet environmental data
Gateways
Get gatewaysGet gateway dataCreate gatewaysDelete a gateway
Jobs
Get jobs state of a deviceGet job state by slcID
Alerts
Get alertsCreate alertsUpdate alerts

Delete devices

Delete one or more devices.

Within a request, all devices must belong to the same customer.

BEWARE: this request cannot be undone.

As content received in a DELETE request has no generally defined semantics, this endpoint does not conform to RFC 9110. We provide it for convenience anyway. It may not be supported by your tools/infrastructure.

API endpoint

device/slcID of customer

Request method

DELETE

Request headers

-

Request URL parameters

-

Request content

EntityTypeNullableDescription
devicearray (mainEntity)no

mainEntity

You can delete devices by slcID, slcDeviceAddress or by serial number.

if more than one attribute is present, then all attributes must match for the device to be deleted.

EntityTypeNullableDescription
idintyesslcID
device_idintyesslcDeviceAddress
serial_numberstringyesserial number of device

Request: example in XML

n.a.

Request: example in JSON

{"device": [
	{
		"id": 1902
	},
	{
		"serial_number": "0492800"
	},
	{
		"device_id": 398370,
		"serial_number": "5273377"
	},
	{
		"device_id": 398239,
		"serial_number": "0492800"
	}
]}