AWS IoT 1-Click
Devices API Reference

Unclaim Device

Unclaims a device using its device ID.

URI

/devices/ deviceId /unclaim

HTTP Methods

PUT

Operation ID: UnclaimDevice

Disassociates a device from your AWS account using its device ID.

Path Parameters

Name Type Required Description
deviceId String True

The unique identifier of the device.

Responses

Status Code Response Model Description
200 DeviceClaimResponse

200 response

400 InvalidRequestException

400 response

404 ResourceNotFoundException

404 response

500 InternalFailureException

500 response

See Also

OPTIONS

Responses

Status Code Response Model Description
200 None

200 response

Schemas

Response Bodies

Example DeviceClaimResponse

{ "state": "string" }

Example InvalidRequestException

{ "code": "string", "message": "string" }

Example ResourceNotFoundException

{ "code": "string", "message": "string" }

Example InternalFailureException

{ "code": "string", "message": "string" }

Properties

DeviceClaimResponse

Property Type Required Description
state

string

False

The device's final claim state.

See Also

InternalFailureException

Property Type Required Description
code

string

False

500

message

string

False

The 500 error message returned by the web server.

See Also

InvalidRequestException

Property Type Required Description
code

string

False

400

message

string

False

The 400 error message returned by the web server.

See Also

ResourceNotFoundException

Property Type Required Description
code

string

False

404

message

string

False

The requested device could not be found.

See Also