Blocks a device on the entitlement, whether or not it has activated, and ends any license it holds.
const url = 'https://example.com/api/v1/provision/operational/entitlements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/devices/block';const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: '{"fingerprint":"example","deviceName":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/v1/provision/operational/entitlements/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/devices/block \ --header 'Content-Type: application/json' \ --data '{ "fingerprint": "example", "deviceName": "example" }'Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”The entitlement.
Request Bodyrequired
Section titled “Request Bodyrequired”The device.
Blocks a device on an entitlement, whether or not it has activated.
object
The device fingerprint the application sends when it activates.
A name to recognize the device by.
Examplegenerated
{ "fingerprint": "example", "deviceName": "example"}Blocks a device on an entitlement, whether or not it has activated.
object
The device fingerprint the application sends when it activates.
A name to recognize the device by.
Examplegenerated
{ "fingerprint": "example", "deviceName": "example"}Blocks a device on an entitlement, whether or not it has activated.
object
The device fingerprint the application sends when it activates.
A name to recognize the device by.
Examplegenerated
{ "fingerprint": "example", "deviceName": "example"}Responses
Section titled “Responses”OK
A device the vendor listed on an entitlement: pre-registered, so an activation code that requires a pre-configured device admits it, or blocked, so no activation admits it.
object
The entry’s id, used to unblock or unregister the device.
The entitlement the device is listed on.
The device fingerprint the application sends when it activates.
A name to recognize the device by.
The device may activate under an activation code that requires a pre-configured device.
The device may not activate this entitlement.
When the device was blocked; null while it is not blocked.
When the device last activated as a pre-registered device; null if it never did.
A device the vendor listed on an entitlement: pre-registered, so an activation code that requires a pre-configured device admits it, or blocked, so no activation admits it.
object
The entry’s id, used to unblock or unregister the device.
The entitlement the device is listed on.
The device fingerprint the application sends when it activates.
A name to recognize the device by.
The device may activate under an activation code that requires a pre-configured device.
The device may not activate this entitlement.
When the device was blocked; null while it is not blocked.
When the device last activated as a pre-registered device; null if it never did.
Examplegenerated
{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fingerprint": "example", "deviceName": "example", "isPreRegistered": true, "isBlocked": true, "blockedAt": "2026-04-15T12:00:00Z", "lastActivatedAt": "2026-04-15T12:00:00Z"}A device the vendor listed on an entitlement: pre-registered, so an activation code that requires a pre-configured device admits it, or blocked, so no activation admits it.
object
The entry’s id, used to unblock or unregister the device.
The entitlement the device is listed on.
The device fingerprint the application sends when it activates.
A name to recognize the device by.
The device may activate under an activation code that requires a pre-configured device.
The device may not activate this entitlement.
When the device was blocked; null while it is not blocked.
When the device last activated as a pre-registered device; null if it never did.
Examplegenerated
{ "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "entitlementId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "fingerprint": "example", "deviceName": "example", "isPreRegistered": true, "isBlocked": true, "blockedAt": "2026-04-15T12:00:00Z", "lastActivatedAt": "2026-04-15T12:00:00Z"}Bad Request
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}Not Found
object
object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}object
Examplegenerated
{ "type": "example", "title": "example", "status": 1, "detail": "example", "instance": "example"}