# AWS IoT 1-Click Projects Service API

> AWS IoT 1-Click Projects Service API on Apizie: 16 endpoints (Associates a physical device with a placement., Removes a physical device from a placement., Lists the placement(s) of a project., Creates an empty placement., …) 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://apizie.tech/v1/cloud:amazonaws-iot1click-projects/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-iot1click-projects`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://apizie.tech/api/cloud/amazonaws-iot1click-projects
- OpenAPI: https://apizie.tech/api/cloud/amazonaws-iot1click-projects/openapi.json

The AWS IoT 1-Click Projects API Reference

## Endpoints

### Associates a physical device with a placement.
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/associate-device-with-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project containing the placement in which to associate the device. |
| placementName | string | yes | The name of the placement in which to associate the device. |
| deviceTemplateName | string | yes | The device template name to associate with the device ID. |
| body | object | yes | JSON request body |

### Removes a physical device from a placement.
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/disassociate-device-from-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project that contains the placement. |
| placementName | string | yes | The name of the placement that the device should be removed from. |
| deviceTemplateName | string | yes | The device ID that should be removed from the placement. |

### Lists the placement(s) of a project.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/list-placements` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The project containing the placements to be listed. |
| nextToken | string | no | The token to retrieve the next set of results. |
| maxResults | integer | no | The maximum number of results to return per request. If not set, a default value of 100 is used. |

### Creates an empty placement.
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/create-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project in which to create the placement. |
| body | object | yes | JSON request body |

### Lists the AWS IoT 1-Click project(s) associated with your AWS account and region.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/list-projects` (byok)

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

### Creates an empty project with a placement template. A project contains zero or more placements that adhere…
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/create-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | yes | JSON request body |

### Describes a placement in a project.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/describe-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| placementName | string | yes | The name of the placement within a project. |
| projectName | string | yes | The project containing the placement to be described. |

### Updates a placement with the given attributes. To clear an attribute, pass an empty value (i.e., "").
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/update-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| placementName | string | yes | The name of the placement to update. |
| projectName | string | yes | The name of the project containing the placement to be updated. |
| body | object | yes | JSON request body |

### Deletes a placement. To delete a placement, it must not have any devices associated with it. When you delete…
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/delete-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| placementName | string | yes | The name of the empty placement to delete. |
| projectName | string | yes | The project containing the empty placement to delete. |

### Returns an object describing a project.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/describe-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project to be described. |

### Updates a project associated with your AWS account and region. With the exception of device template names,…
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/update-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project to be updated. |
| body | object | yes | JSON request body |

### Deletes a project. To delete a project, it must not have any placements associated with it. When you delete…
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/delete-project` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the empty project to delete. |

### Returns an object enumerating the devices in a placement.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/get-devices-in-placement` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| projectName | string | yes | The name of the project containing the placement. |
| placementName | string | yes | The name of the placement to get the devices from. |

### Lists the tags (metadata key/value pairs) which you have assigned to the resource.
`GET https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the resource whose tags you want to list. |

### Creates or modifies tags for a resource. Tags are key/value pairs (metadata) that can be used to manage a…
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the resouce for which tag(s) should be added or modified. |
| body | object | yes | JSON request body |

### Removes one or more tags (metadata key/value pairs) from a resource.
`POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the resource whose tag you want to remove. |
| tagKeys | array | yes | The keys of those tags which you want to remove. |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/associate-device-with-placement" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS IoT 1-Click Projects Service API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-iot1click-projects/associate-device-with-placement with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS IoT 1-Click Projects 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 Projects Service itself also needs your own key from amazonaws.com.

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

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