Deprovision/remove Device
POST/v1/device/deprovision
This endpoint allows you to securely deprovision a signageOS device using its authHash. It is especially useful in cases where the user has physical access to the device, but does not have access to the signageOS account under which the device was originally provisioned. When to Use This Endpoint:
- You have a “lost” or “orphaned” device that was previously provisioned under a different signageOS account.
- You physically control the device, but don’t have access to its current provisioning record in the signageOS platform.
- You are using a custom recovery Applet or utility to retrieve the device’s authHash directly via the sos.authHash property in the JavaScript SDK.
- You need to reset or reclaim ownership of a device to provision it under a new account.
- How to deprovision device via Box or REST API Attention: this endpoint requires your Account token. You cannot use organization token.
Request
Responses
- 200
- 400
- 403
- 404
Success
Response Headers
Content-Type
Bad request
Response Headers
Content-Type
Forbidden
Response Headers
Content-Type
Not Found
Response Headers
Content-Type