{"files":{"SKILL.md":"---\nname: aws-iot-events-data\ndescription: \"AWS IoT Events Data API skill. Use when working with AWS IoT Events Data for alarms, detectors, inputs. Covers 12 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AWS IoT Events Data\nAPI version: 2018-10-23\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /alarms/{alarmModelName}/keyValues/ -- retrieves information about an alarm.\n3. POST /alarms/acknowledge -- create first acknowledge\n\n## Endpoints\n12 endpoints across 3 groups. See references/api-spec.lap for full details.\n\n### Alarms\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /alarms/acknowledge | Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them. |\n| POST | /alarms/disable | Disables one or more alarms. The alarms change to the DISABLED state after you disable them. |\n| POST | /alarms/enable | Enables one or more alarms. The alarms change to the NORMAL state after you enable them. |\n| POST | /alarms/reset | Resets one or more alarms. The alarms return to the NORMAL state after you reset them. |\n| POST | /alarms/snooze | Changes one or more alarms to the snooze mode. The alarms change to the SNOOZE_DISABLED state after you set them to the snooze mode. |\n| GET | /alarms/{alarmModelName}/keyValues/ | Retrieves information about an alarm. |\n| GET | /alarms/{alarmModelName} | Lists one or more alarms. The operation returns only the metadata associated with each alarm. |\n\n### Detectors\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /detectors/delete | Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and the detector will be removed from the list of detectors. The deleted detector will no longer appear if referenced in the ListDetectors API call. |\n| POST | /detectors | Updates the state, variable values, and timer settings of one or more detectors (instances) of a specified detector model. |\n| GET | /detectors/{detectorModelName}/keyValues/ | Returns information about the specified detector (instance). |\n| GET | /detectors/{detectorModelName} | Lists detectors (the instances of a detector model). |\n\n### Inputs\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /inputs/messages | Sends a set of messages to the IoT Events system. Each message payload is transformed into the input you specify (\"inputName\") and ingested into any detectors that monitor that input. If multiple messages are sent, the order in which the messages are processed isn't guaranteed. To guarantee ordering, you must send messages one at a time and wait for a successful response. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a acknowledge?\" -> POST /alarms/acknowledge\n- \"Create a delete?\" -> POST /detectors/delete\n- \"Create a disable?\" -> POST /alarms/disable\n- \"Create a enable?\" -> POST /alarms/enable\n- \"Create a message?\" -> POST /inputs/messages\n- \"Create a reset?\" -> POST /alarms/reset\n- \"Create a snooze?\" -> POST /alarms/snooze\n- \"Create a detector?\" -> POST /detectors\n- \"List all keyValues?\" -> GET /alarms/{alarmModelName}/keyValues/\n- \"Get alarm details?\" -> GET /alarms/{alarmModelName}\n- \"Get detector details?\" -> GET /detectors/{detectorModelName}\n- \"How to authenticate?\" -> See Auth section above\n\n## Response Tips\n- Check response schemas in references/api-spec.lap for field details\n- Create/update endpoints return the modified resource on success\n\n## References\n- Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas\n\n> Generated from the official API spec by [LAP](https://lap.sh)\n","references/api-spec.lap":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AWS IoT Events Data\n@version 2018-10-23\n@auth AWS SigV4\n@endpoints 12\n@toc alarms(7), detectors(4), inputs(1)\n\n@group alarms\n@endpoint POST /alarms/acknowledge\n@desc Acknowledges one or more alarms. The alarms change to the ACKNOWLEDGED state after you acknowledge them.\n@required {acknowledgeActionRequests: [AcknowledgeAlarmActionRequest]}\n@returns(200) {errorEntries: [BatchAlarmActionErrorEntry]?}\n\n@endgroup\n\n@group detectors\n@endpoint POST /detectors/delete\n@desc Deletes one or more detectors that were created. When a detector is deleted, its state will be cleared and the detector will be removed from the list of detectors. The deleted detector will no longer appear if referenced in the ListDetectors API call.\n@required {detectors: [DeleteDetectorRequest]}\n@returns(200) {batchDeleteDetectorErrorEntries: [BatchDeleteDetectorErrorEntry]?}\n\n@endgroup\n\n@group alarms\n@endpoint POST /alarms/disable\n@desc Disables one or more alarms. The alarms change to the DISABLED state after you disable them.\n@required {disableActionRequests: [DisableAlarmActionRequest]}\n@returns(200) {errorEntries: [BatchAlarmActionErrorEntry]?}\n\n@endpoint POST /alarms/enable\n@desc Enables one or more alarms. The alarms change to the NORMAL state after you enable them.\n@required {enableActionRequests: [EnableAlarmActionRequest]}\n@returns(200) {errorEntries: [BatchAlarmActionErrorEntry]?}\n\n@endgroup\n\n@group inputs\n@endpoint POST /inputs/messages\n@desc Sends a set of messages to the IoT Events system. Each message payload is transformed into the input you specify (\"inputName\") and ingested into any detectors that monitor that input. If multiple messages are sent, the order in which the messages are processed isn't guaranteed. To guarantee ordering, you must send messages one at a time and wait for a successful response.\n@required {messages: [Message]}\n@returns(200) {BatchPutMessageErrorEntries: [BatchPutMessageErrorEntry]?}\n\n@endgroup\n\n@group alarms\n@endpoint POST /alarms/reset\n@desc Resets one or more alarms. The alarms return to the NORMAL state after you reset them.\n@required {resetActionRequests: [ResetAlarmActionRequest]}\n@returns(200) {errorEntries: [BatchAlarmActionErrorEntry]?}\n\n@endpoint POST /alarms/snooze\n@desc Changes one or more alarms to the snooze mode. The alarms change to the SNOOZE_DISABLED state after you set them to the snooze mode.\n@required {snoozeActionRequests: [SnoozeAlarmActionRequest]}\n@returns(200) {errorEntries: [BatchAlarmActionErrorEntry]?}\n\n@endgroup\n\n@group detectors\n@endpoint POST /detectors\n@desc Updates the state, variable values, and timer settings of one or more detectors (instances) of a specified detector model.\n@required {detectors: [UpdateDetectorRequest]}\n@returns(200) {batchUpdateDetectorErrorEntries: [BatchUpdateDetectorErrorEntry]?}\n\n@endgroup\n\n@group alarms\n@endpoint GET /alarms/{alarmModelName}/keyValues/\n@desc Retrieves information about an alarm.\n@required {alarmModelName: str}\n@optional {keyValue: str}\n@returns(200) {alarm: Alarm?{alarmModelName: str?, alarmModelVersion: str?, keyValue: str?, alarmState: AlarmState?{stateName: str?, ruleEvaluation: RuleEvaluation?{simpleRuleEvaluation: SimpleRuleEvaluation?}, customerAction: CustomerAction?{actionName: str?, snoozeActionConfiguration: SnoozeActionConfiguration?, enableActionConfiguration: EnableActionConfiguration?, disableActionConfiguration: DisableActionConfiguration?, acknowledgeActionConfiguration: AcknowledgeActionConfiguration?, resetActionConfiguration: ResetActionConfiguration?}, systemEvent: SystemEvent?{eventType: str?, stateChangeConfiguration: StateChangeConfiguration?}}, severity: int?, creationTime: str(timestamp)?, lastUpdateTime: str(timestamp)?}}\n\n@endgroup\n\n@group detectors\n@endpoint GET /detectors/{detectorModelName}/keyValues/\n@desc Returns information about the specified detector (instance).\n@required {detectorModelName: str}\n@optional {keyValue: str}\n@returns(200) {detector: Detector?{detectorModelName: str?, keyValue: str?, detectorModelVersion: str?, state: DetectorState?{stateName: str, variables: [Variable], timers: [Timer]}, creationTime: str(timestamp)?, lastUpdateTime: str(timestamp)?}}\n\n@endgroup\n\n@group alarms\n@endpoint GET /alarms/{alarmModelName}\n@desc Lists one or more alarms. The operation returns only the metadata associated with each alarm.\n@required {alarmModelName: str}\n@optional {nextToken: str, maxResults: int}\n@returns(200) {alarmSummaries: [AlarmSummary]?, nextToken: str?}\n\n@endgroup\n\n@group detectors\n@endpoint GET /detectors/{detectorModelName}\n@desc Lists detectors (the instances of a detector model).\n@required {detectorModelName: str}\n@optional {stateName: str, nextToken: str, maxResults: int}\n@returns(200) {detectorSummaries: [DetectorSummary]?, nextToken: str?}\n\n@endgroup\n\n@end\n"}}