POST/v1/devices/{device-id}/remote-deactivationRemote deactivate a device

This method allows you to remotely deactivate a device, using a gateway. This is the logical opposite of /remote-activation
parameternearbyBoolean, indicating if the device-event should be flagged as nearby: Boolean
parameteruuidWeb-key UUID for unauthenticated remote deactivation: String, UUID 4 formatted (e.g. "a426e157-8a5c-456a-8865-bec6394867ab")
parameterlanguagePreferred language for error messages: Language code (ISO 639-1, e.g. "ar", "de", "en", "es", "fr", "it", "nl", "pl", "cs")
headerAuthorizationAuthentication token (bearer token or API key).

Response

status200All ok
status401Invalid authentication token
status403Insufficient rights
status404Device/Gateway not found
{
"deviceId" : Number,
"errorCode" : String,
"errorMessage" : String,
"activationTime" : Number
}

Example: Remote deactivate, lock firmware <= 102 or gateway firmware <= 43

POST/v1/devices/26/remote-deactivation

headerAuthorizationBearer 5d225a8b-256f-476a-869f-55149747a289

Response

status400
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"message": "A new firmware update is available for your Bold product. We recommend to update to the newest version to have the best experience.",
"code": "DeviceFirmwareOutdated",
"errorMessage": "A new firmware update is available for your Bold product. We recommend to update to the newest version to have the best experience.",
"errorCode": "DeviceFirmwareOutdated"
}

Example: Remote deactivate without gateway

POST/v1/devices/30/remote-deactivation

headerAuthorizationBearer abf99c9b-c517-41dd-bdf2-dc5c8deaa130

Response

status400
headerAccess-Control-Expose-Headersauthorization, content-type
headerAccess-Control-Allow-Headersauthorization, content-type
headerAccess-Control-Allow-MethodsGET, POST, DELETE, OPTIONS, PUT
headerAccess-Control-Allow-Origin*
headerStrict-Transport-Securitymax-age=31536000; includeSubDomains
headerX-Frame-OptionsSAMEORIGIN
headerX-Content-Type-Optionsnosniff
headerX-XSS-Protection1; mode=block
headerContent-Security-Policydefault-src 'none'; frame-ancestors 'none'; base-uri 'none'; form-action 'none'
headerReferrer-Policyno-referrer
headerFeature-Policyself
headerPermissions-policyinterest-cohort=()
{
"message": "No available Connect for Lock found. Please check if your connect is online.",
"code": "gatewayNotFoundError",
"errorMessage": "No available Connect for Lock found. Please check if your connect is online.",
"errorCode": "gatewayNotFoundError"
}