PUT
/devices/{deviceId}/finalize-claim
http://devices.iot1click.{region}.amazonaws.com/devices/{deviceId}/finalize-claim<p>Given a device ID, finalizes the claim request for the associated device.</p><note> <p>Claiming a device consists of initiating a claim, then publishing a device event, and finalizing the claim. For a device of type button, a device event can be published by simply clicking the device.</p> </note>
Access Token Required: API Key
Path Parameters
deviceIdstringrequired
The unique identifier of the device.
Body Params
tagsobject
<p>A collection of key/value pairs defining the resource tags. For example, { "tags": {"key1": "value1", "key2": "value2"} }. For more information, see <a href="https://aws.amazon.com/answers/account-management/aws-tagging-strategies/">AWS Tagging Strategies</a>.</p><p> </p>
Responses
{
"success": true,
"data": {
"id": "abc123",
"created_at": "2025-01-01T00:00:00Z"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "Invalid request parameters"
}
}Language
CredentialsAPI KEY
API Key
Enter token below to save for later
cURL Request
1curl --request PUT \2 --url 'http://devices.iot1click.{region}.amazonaws.com/devices/{deviceId}/finalize-claim' \3 --header 'accept: application/json' \4 --header 'content-type: application/json'Response
1{2 "success": true,3 "data": {4 "id": "abc123",5 "created_at": "2025-01-01T00:00:00Z"6 }7}