Claiming

Device Claiming lets an end user securely associate a deployed device with their account. For a full explanation of the claiming workflow, see Claiming Devices.

See Getting Connected for authentication and connection details.

Claiming Request

The device initiates claiming by sending a POST request:

POST http(s)://THINGSBOARD_HOST/api/v1/$ACCESS_TOKEN/claim

{"secretKey": "mySecret", "durationMs": 60000}

curl -s -X POST -H "Content-Type: application/json" -d '{"secretKey":"mySecret","durationMs":60000}' "http://$THINGSBOARD_HOST/api/v1/$ACCESS_TOKEN/claim"

Field	Required	Description
`secretKey`	No	Secret used to authorize the claim. Defaults to an empty string if omitted.
`durationMs`	No	Time window in milliseconds during which the device can be claimed. Defaults to the system value of `SECURITY_CLAIM_DURATION`.