Skip to content
Spoke Zone Docs

Device Deletion

Only Super Users can delete devices on Spoke Zone.

Request

The API endpoint for deleting devices is DELETE /api/v2/devices.

Example: DELETE /api/v2/devices?ids=1,2,3

Be sure to provide your super user access token in the x-access-token header.

Please see the API errors page for information about any API errors you receive from this endpoint.

Query Parameters

Required

  • ids
    • A comma-separated list of device IDs to delete.

Error Responses

If you get an error while deleting devices, try these steps and then retry the deletion request.

When a device is deleted successfully, you will get a response like {"message":"Bulk delete complete.","deleteCount":1}.

Device has Data Files. Please delete them first.

All the data files for the device must be deleted.

You can quickly delete all the data files for a device through the Delete Device Data section of the device editor.

Device has Dashboards. Please delete them first.

The device must be removed from all dashboards.