# AWS IoT Events API

> AWS IoT Events API on Apizie: 26 endpoints (Lists the alarm models that you created. The operation returns only the metadata associated with each alarm…, Creates an alarm model to monitor an AWS IoT Events input attribute. You can use the alarm to get notified…, Lists the detector models you have created. Only the metadata associated with each detector model is returned., Creates a detector model., …) 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-iotevents/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

AWS IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. You can use AWS IoT Events API operations to create, read, update, and delete…

## Endpoints

### Lists the alarm models that you created. The operation returns only the metadata associated with each alarm…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-alarm-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Creates an alarm model to monitor an AWS IoT Events input attribute. You can use the alarm to get notified…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/create-alarm-model` (byok)

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

### Lists the detector models you have created. Only the metadata associated with each detector model is returned.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-detector-models` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Creates a detector model.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/create-detector-model` (byok)

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

### Lists the inputs you have created.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-inputs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Creates an input.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/create-input` (byok)

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

### Retrieves information about an alarm model. If you don't specify a value for the alarmModelVersion…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/describe-alarm-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| alarmModelName | string | yes | The name of the alarm model. |
| version | string | no | The version of the alarm model. |

### Updates an alarm model. Any alarms that were created based on the previous version are deleted and then…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/update-alarm-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| alarmModelName | string | yes | The name of the alarm model. |
| body | object | yes | JSON request body |

### Deletes an alarm model. Any alarm instances that were created based on this alarm model are also deleted.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/delete-alarm-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| alarmModelName | string | yes | The name of the alarm model. |

### Describes a detector model. If the version parameter is not specified, information about the latest version…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/describe-detector-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model. |
| version | string | no | The version of the detector model. |

### Updates a detector model. Detectors (instances) spawned by the previous version are deleted and then…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/update-detector-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model that is updated. |
| body | object | yes | JSON request body |

### Deletes a detector model. Any active instances of the detector model are also deleted.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/delete-detector-model` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model to be deleted. |

### Describes an input.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/describe-input` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| inputName | string | yes | The name of the input. |

### Updates an input.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/update-input` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| inputName | string | yes | The name of the input you want to update. |
| body | object | yes | JSON request body |

### Deletes an input.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/delete-input` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| inputName | string | yes | The name of the input to delete. |

### Retrieves runtime information about a detector model analysis. After AWS IoT Events starts analyzing your…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/describe-detector-model-analysis` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| analysisId | string | yes | The ID of the analysis result that you want to retrieve. |

### Retrieves the current settings of the AWS IoT Events logging options.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/describe-logging-options` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |

### Sets or updates the AWS IoT Events logging options. If you update the value of any loggingOptions field, it…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/put-logging-options` (byok)

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

### Retrieves one or more analysis results of the detector model. After AWS IoT Events starts analyzing your…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/get-detector-model-analysis-results` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| analysisId | string | yes | The ID of the analysis result that you want to retrieve. |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Lists all the versions of an alarm model. The operation returns only the metadata associated with each alarm…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-alarm-model-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| alarmModelName | string | yes | The name of the alarm model. |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Lists all the versions of a detector model. Only the metadata associated with each detector model version is…
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-detector-model-versions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model whose versions are returned. |
| nextToken | string | no | The token that you can use to return the next set of results. |
| maxResults | integer | no | The maximum number of results to be returned per request. |

### Lists one or more input routings.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-input-routings` (byok)

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

### Lists the tags (metadata) you have assigned to the resource.
`GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-tags-for-resource` (byok)

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

### Adds to or modifies the tags of the given resource. Tags are metadata that can be used to manage a resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/tag-resource` (byok)

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

### Performs an analysis of your detector model. For more information, see Troubleshooting a detector model in…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/start-detector-model-analysis` (byok)

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

### Removes the given tags (metadata) from the resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| resourceArn | string | yes | The ARN of the resource. |
| tagKeys | array | yes | A list of the keys of the tags to be removed from the resource. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-alarm-models" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS IoT Events API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:amazonaws-iotevents/list-alarm-models with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the AWS IoT Events 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-iotevents.

### What is the status of the AWS IoT Events API?
Needs your own provider key (bring your own key)