Delete a device
Remove the specified device from the system.
Middlewares: authMiddleware, validateDevice, validateOrganizationDelete
API key for authentication
In: header
Path Parameters
A valid MongoDB ObjectId
Response Body
application/json
curl -X DELETE "https://api.paperlesspaper.de/v1/devices/682fd0d7d4a6325d9d45b86f"{
"success": true,
"message": "Operation completed successfully"
}Deactivate Device DELETE
Admin-or-support, dry-run-first deactivation by epd DeviceId. Missing app records produce warnings and do not block IoT deactivation. An optional previousDeviceObjectId from the admin search allows orphaned paper assignments to be detached; without a known app id, papers remain unchanged. A dry run is the default and returns the papers currently attached plus a confirmationToken. Papers and their cross-paper references are preserved. To execute, repeat with dryRun=false and that token. After a confirmed IoT reset, cleanup can be retried with the same token without resetting the device again; a completed request returns its saved result. Cleanup only affects the original database device and detaches its remaining paper references. Change counts describe the successful cleanup attempt. Middlewares: `authMiddleware`, `validateAdminOrSupport`
Get a device by ID GET
Retrieve detailed information for the device identified by its ID. Middlewares: `authMiddleware`, `validateDevice`