Put devicesdeviceidfinalize claim — iot1click-devices

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14134933.3 KB

Given a device ID, finalizes the claim request for the associated device.

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.

put/devices/{deviceId}/finalize-claim

Path parameters

deviceIdstring required

The unique identifier of the device.

Request body

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>

Response

Success

Statestring

The device's final claim state.