Skip to main content

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.

Access: this is a destructive cross-tenant operation gated behind the key-account-only DeviceForceDeprovision company feature entitlement, which must be requested from signageOS support. The entitlement is granted to the caller's company (not per organization) — any account of an entitled company may deprovision devices from any organization. Callers whose company lacks the entitlement receive 402. 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. To deprovision a device you own (identified by its UID), use PUT /v1/device/{deviceUid}/deprovision instead — that path is guarded by the standard device ACL and needs no entitlement.

Request​

Responses​

Success