# AWS IoT 1-Click Devices Service API

> AWS IoT 1-Click Devices Service API on Apizie: 13 endpoints (Adds device(s) to your account (i.e., claim one or more devices) if and only if you received a claim code…, Given a device ID, returns a DescribeDeviceResponse object describing the details of the device., Given a device ID, finalizes the claim request for the associated device. Claiming a device consists of…, Given a device ID, returns the invokable methods associated with the device., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-iot1click-devices`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-iot1click-devices
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-iot1click-devices/openapi.json

Describes all of the AWS IoT 1-Click device-related API operations for the service. Also provides sample requests, responses, and errors for the supported web services protocols.

## Endpoints

### Adds device(s) to your account (i.e., claim one or more devices) if and only if you received a claim code…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/claim-devices-by-claim-code` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| claimCode | string | yes | The claim code, starting with "C-", as provided by the device manufacturer. |

### Given a device ID, returns a DescribeDeviceResponse object describing the details of the device.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/describe-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |

### Given a device ID, finalizes the claim request for the associated device. Claiming a device consists of…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/finalize-device-claim` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |
| body | object | yes | JSON request body |

### Given a device ID, returns the invokable methods associated with the device.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/get-device-methods` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |

### Given a device ID, issues a request to invoke a named device method (with possible parameters). See the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/invoke-device-method` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |
| body | object | yes | JSON request body |

### Given a device ID, initiates a claim request for the associated device. Claiming a device consists of…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/initiate-device-claim` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |

### Using a device ID, returns a DeviceEventsResponse object containing an array of events for the device.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/list-device-events` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |
| fromTimeStamp | string | yes | The start date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z |
| maxResults | integer | no | The maximum number of results to return per request. If not set, a default value of 100 is used. |
| nextToken | string | no | The token to retrieve the next set of results. |
| toTimeStamp | string | yes | The end date for the device event query, in ISO8061 format. For example, 2018-03-28T15:45:12.880Z |

### Lists the 1-Click compatible devices associated with your AWS account.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/list-devices` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceType | string | no | The type of the device, such as "button". |
| maxResults | integer | no | The maximum number of results to return per request. If not set, a default value of 100 is used. |
| nextToken | string | no | The token to retrieve the next set of results. |

### Lists the tags associated with the specified resource ARN.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resource-arn | string | yes | The ARN of the resource. |

### Adds or updates the tags associated with the resource ARN. See AWS IoT 1-Click Service Limits for the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resource-arn | string | yes | The ARN of the resource. |
| body | object | yes | JSON request body |

### Disassociates a device from your AWS account using its device ID.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/unclaim-device` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |

### Using tag keys, deletes the tags (key/value pairs) associated with the specified resource ARN.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resource-arn | string | yes | The ARN of the resource. |
| tagKeys | array | yes | A collections of tag keys. For example, {"key1","key2"} |

### Using a Boolean value (true or false), this operation enables or disables the device given a device ID.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/update-device-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| deviceId | string | yes | The unique identifier of the device. |
| body | object | yes | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/claim-devices-by-claim-code" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS IoT 1-Click Devices Service API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-iot1click-devices/claim-devices-by-claim-code with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS IoT 1-Click Devices Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. AWS IoT 1-Click Devices Service itself also needs your own key from amazonaws.com.

### Can AI agents use the AWS IoT 1-Click Devices Service API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-iot1click-devices.

### What is the status of the AWS IoT 1-Click Devices Service API?
Needs your own provider key (bring your own key)