# AWS IoT Events Data API

> AWS IoT Events Data API on Apizie: 12 endpoints (Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them., Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and…, Disables one or more alarms. The alarms change to the DISABLED state after you disable them., Enables one or more alarms. The alarms change to the NORMAL state after you enable them., …) 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-iotevents-data/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

IoT Events monitors your equipment or device fleets for failures or changes in operation, and triggers actions when such events occur. You can use IoT Events Data API commands to send inputs to detectors, list…

## Endpoints

### Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them.
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-acknowledge-alarm` (byok)

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

### Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and…
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-delete-detector` (byok)

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

### Disables one or more alarms. The alarms change to the DISABLED state after you disable them.
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-disable-alarm` (byok)

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

### Enables one or more alarms. The alarms change to the NORMAL state after you enable them.
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-enable-alarm` (byok)

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

### Sends a set of messages to the IoT Events system. Each message payload is transformed into the input you…
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-put-message` (byok)

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

### Resets one or more alarms. The alarms return to the NORMAL state after you reset them.
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-reset-alarm` (byok)

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

### Changes one or more alarms to the snooze mode. The alarms change to the SNOOZE_DISABLED state after you set…
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-snooze-alarm` (byok)

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

### Updates the state, variable values, and timer settings of one or more detectors (instances) of a specified…
`POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-update-detector` (byok)

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

### Retrieves information about an alarm.
`GET https://apizie.tech/v1/cloud:amazonaws-iotevents-data/describe-alarm` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| alarmModelName | string | yes | The name of the alarm model. |
| keyValue | string | no | The value of the key used as a filter to select only the alarms associated with the key . |

### Returns information about the specified detector (instance).
`GET https://apizie.tech/v1/cloud:amazonaws-iotevents-data/describe-detector` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model whose detectors (instances) you want information about. |
| keyValue | string | no | A filter used to limit results to detectors (instances) created because of the given key ID. |

### Lists one or more alarms. The operation returns only the metadata associated with each alarm.
`GET https://apizie.tech/v1/cloud:amazonaws-iotevents-data/list-alarms` (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 detectors (the instances of a detector model).
`GET https://apizie.tech/v1/cloud:amazonaws-iotevents-data/list-detectors` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| detectorModelName | string | yes | The name of the detector model whose detectors (instances) are listed. |
| stateName | string | no | A filter that limits results to those detectors (instances) in the given state. |
| 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. |

## Example
```
curl "https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-acknowledge-alarm" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the AWS IoT Events Data API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:amazonaws-iotevents-data/batch-acknowledge-alarm with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the AWS IoT Events Data 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 Data itself also needs your own key from amazonaws.com.

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

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