{"files":{"SKILL.md":"---\nname: aws-systems-manager-incident-manager\ndescription: \"AWS Systems Manager Incident Manager API skill. Use when working with AWS Systems Manager Incident Manager for batchGetIncidentFindings, createReplicationSet, createResponsePlan. Covers 31 endpoints.\"\nversion: 1.0.0\ngenerator: lapsh\n---\n\n# AWS Systems Manager Incident Manager\nAPI version: 2018-05-10\n\n## Auth\nAWS SigV4\n\n## Base URL\nNot specified.\n\n## Setup\n1. Configure auth: AWS SigV4\n2. GET /getIncidentRecord -- returns the details for the specified incident record.\n3. POST /batchGetIncidentFindings -- create first batchGetIncidentFinding\n\n## Endpoints\n31 endpoints across 29 groups. See references/api-spec.lap for full details.\n\n### BatchGetIncidentFindings\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /batchGetIncidentFindings | Retrieves details about all specified findings for an incident, including descriptive details about each finding. A finding represents a recent application environment change made by an CodeDeploy deployment or an CloudFormation stack creation or update that can be investigated as a potential cause of the incident. |\n\n### CreateReplicationSet\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /createReplicationSet | A replication set replicates and encrypts your data to the provided Regions with the provided KMS key. |\n\n### CreateResponsePlan\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /createResponsePlan | Creates a response plan that automates the initial response to incidents. A response plan engages contacts, starts chat channel collaboration, and initiates runbooks at the beginning of an incident. |\n\n### CreateTimelineEvent\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /createTimelineEvent | Creates a custom timeline event on the incident details page of an incident record. Incident Manager automatically creates timeline events that mark key moments during an incident. You can create custom timeline events to mark important events that Incident Manager can detect automatically. |\n\n### DeleteIncidentRecord\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /deleteIncidentRecord | Delete an incident record from Incident Manager. |\n\n### DeleteReplicationSet\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /deleteReplicationSet | Deletes all Regions in your replication set. Deleting the replication set deletes all Incident Manager data. |\n\n### DeleteResourcePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /deleteResourcePolicy | Deletes the resource policy that Resource Access Manager uses to share your Incident Manager resource. |\n\n### DeleteResponsePlan\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /deleteResponsePlan | Deletes the specified response plan. Deleting a response plan stops all linked CloudWatch alarms and EventBridge events from creating an incident with this response plan. |\n\n### DeleteTimelineEvent\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /deleteTimelineEvent | Deletes a timeline event from an incident. |\n\n### GetIncidentRecord\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /getIncidentRecord | Returns the details for the specified incident record. |\n\n### GetReplicationSet\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /getReplicationSet | Retrieve your Incident Manager replication set. |\n\n### GetResourcePolicies\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /getResourcePolicies | Retrieves the resource policies attached to the specified response plan. |\n\n### GetResponsePlan\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /getResponsePlan | Retrieves the details of the specified response plan. |\n\n### GetTimelineEvent\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /getTimelineEvent | Retrieves a timeline event based on its ID and incident record. |\n\n### ListIncidentFindings\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listIncidentFindings | Retrieves a list of the IDs of findings, plus their last modified times, that have been identified for a specified incident. A finding represents a recent application environment change made by an CloudFormation stack creation or update or an CodeDeploy deployment that can be investigated as a potential cause of the incident. |\n\n### ListIncidentRecords\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listIncidentRecords | Lists all incident records in your account. Use this command to retrieve the Amazon Resource Name (ARN) of the incident record you want to update. |\n\n### ListRelatedItems\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listRelatedItems | List all related items for an incident record. |\n\n### ListReplicationSets\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listReplicationSets | Lists details about the replication set configured in your account. |\n\n### ListResponsePlans\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listResponsePlans | Lists all response plans in your account. |\n\n### Tags\n| Method | Path | Description |\n|--------|------|-------------|\n| GET | /tags/{resourceArn} | Lists the tags that are attached to the specified response plan or incident. |\n| POST | /tags/{resourceArn} | Adds a tag to a response plan. |\n| DELETE | /tags/{resourceArn} | Removes a tag from a resource. |\n\n### ListTimelineEvents\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /listTimelineEvents | Lists timeline events for the specified incident record. |\n\n### PutResourcePolicy\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /putResourcePolicy | Adds a resource policy to the specified response plan. The resource policy is used to share the response plan using Resource Access Manager (RAM). For more information about cross-account sharing, see Cross-Region and cross-account incident management. |\n\n### StartIncident\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /startIncident | Used to start an incident from CloudWatch alarms, EventBridge events, or manually. |\n\n### UpdateDeletionProtection\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateDeletionProtection | Update deletion protection to either allow or deny deletion of the final Region in a replication set. |\n\n### UpdateIncidentRecord\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateIncidentRecord | Update the details of an incident record. You can use this operation to update an incident record from the defined chat channel. For more information about using actions in chat channels, see Interacting through chat. |\n\n### UpdateRelatedItems\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateRelatedItems | Add or remove related items from the related items tab of an incident record. |\n\n### UpdateReplicationSet\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateReplicationSet | Add or delete Regions from your replication set. |\n\n### UpdateResponsePlan\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateResponsePlan | Updates the specified response plan. |\n\n### UpdateTimelineEvent\n| Method | Path | Description |\n|--------|------|-------------|\n| POST | /updateTimelineEvent | Updates a timeline event. You can update events of type Custom Event. |\n\n## Common Questions\nMatch user requests to endpoints in references/api-spec.lap. Key patterns:\n- \"Create a batchGetIncidentFinding?\" -> POST /batchGetIncidentFindings\n- \"Create a createReplicationSet?\" -> POST /createReplicationSet\n- \"Create a createResponsePlan?\" -> POST /createResponsePlan\n- \"Create a createTimelineEvent?\" -> POST /createTimelineEvent\n- \"Create a deleteIncidentRecord?\" -> POST /deleteIncidentRecord\n- \"Create a deleteReplicationSet?\" -> POST /deleteReplicationSet\n- \"Create a deleteResourcePolicy?\" -> POST /deleteResourcePolicy\n- \"Create a deleteResponsePlan?\" -> POST /deleteResponsePlan\n- \"Create a deleteTimelineEvent?\" -> POST /deleteTimelineEvent\n- \"List all getIncidentRecord?\" -> GET /getIncidentRecord\n- \"List all getReplicationSet?\" -> GET /getReplicationSet\n- \"Create a getResourcePolicy?\" -> POST /getResourcePolicies\n- \"List all getResponsePlan?\" -> GET /getResponsePlan\n- \"List all getTimelineEvent?\" -> GET /getTimelineEvent\n- \"Create a listIncidentFinding?\" -> POST /listIncidentFindings\n- \"Create a listIncidentRecord?\" -> POST /listIncidentRecords\n- \"Create a listRelatedItem?\" -> POST /listRelatedItems\n- \"Create a listReplicationSet?\" -> POST /listReplicationSets\n- \"Create a listResponsePlan?\" -> POST /listResponsePlans\n- \"Get tag details?\" -> GET /tags/{resourceArn}\n- \"Create a listTimelineEvent?\" -> POST /listTimelineEvents\n- \"Create a putResourcePolicy?\" -> POST /putResourcePolicy\n- \"Create a startIncident?\" -> POST /startIncident\n- \"Delete a tag?\" -> DELETE /tags/{resourceArn}\n- \"Create a updateDeletionProtection?\" -> POST /updateDeletionProtection\n- \"Create a updateIncidentRecord?\" -> POST /updateIncidentRecord\n- \"Create a updateRelatedItem?\" -> POST /updateRelatedItems\n- \"Create a updateReplicationSet?\" -> POST /updateReplicationSet\n- \"Create a updateResponsePlan?\" -> POST /updateResponsePlan\n- \"Create a updateTimelineEvent?\" -> POST /updateTimelineEvent\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 Systems Manager Incident Manager\n@version 2018-05-10\n@auth AWS SigV4\n@endpoints 31\n@hint download_for_search\n@toc batchGetIncidentFindings(1), createReplicationSet(1), createResponsePlan(1), createTimelineEvent(1), deleteIncidentRecord(1), deleteReplicationSet(1), deleteResourcePolicy(1), deleteResponsePlan(1), deleteTimelineEvent(1), getIncidentRecord(1), getReplicationSet(1), getResourcePolicies(1), getResponsePlan(1), getTimelineEvent(1), listIncidentFindings(1), listIncidentRecords(1), listRelatedItems(1), listReplicationSets(1), listResponsePlans(1), tags(3), listTimelineEvents(1), putResourcePolicy(1), startIncident(1), updateDeletionProtection(1), updateIncidentRecord(1), updateRelatedItems(1), updateReplicationSet(1), updateResponsePlan(1), updateTimelineEvent(1)\n\n@group batchGetIncidentFindings\n@endpoint POST /batchGetIncidentFindings\n@desc Retrieves details about all specified findings for an incident, including descriptive details about each finding. A finding represents a recent application environment change made by an CodeDeploy deployment or an CloudFormation stack creation or update that can be investigated as a potential cause of the incident.\n@required {findingIds: [str], incidentRecordArn: str}\n@returns(200) {errors: [BatchGetIncidentFindingsError], findings: [Finding]}\n\n@endgroup\n\n@group createReplicationSet\n@endpoint POST /createReplicationSet\n@desc A replication set replicates and encrypts your data to the provided Regions with the provided KMS key.\n@required {regions: map<str,RegionMapInputValue>}\n@optional {clientToken: str, tags: map<str,str>}\n@returns(200) {arn: str}\n\n@endgroup\n\n@group createResponsePlan\n@endpoint POST /createResponsePlan\n@desc Creates a response plan that automates the initial response to incidents. A response plan engages contacts, starts chat channel collaboration, and initiates runbooks at the beginning of an incident.\n@required {incidentTemplate: IncidentTemplate, name: str}\n@optional {actions: [Action], chatChannel: ChatChannel, clientToken: str, displayName: str, engagements: [str], integrations: [Integration], tags: map<str,str>}\n@returns(200) {arn: str}\n\n@endgroup\n\n@group createTimelineEvent\n@endpoint POST /createTimelineEvent\n@desc Creates a custom timeline event on the incident details page of an incident record. Incident Manager automatically creates timeline events that mark key moments during an incident. You can create custom timeline events to mark important events that Incident Manager can detect automatically.\n@required {eventData: str, eventTime: str(timestamp), eventType: str, incidentRecordArn: str}\n@optional {clientToken: str, eventReferences: [EventReference]}\n@returns(200) {eventId: str, incidentRecordArn: str}\n\n@endgroup\n\n@group deleteIncidentRecord\n@endpoint POST /deleteIncidentRecord\n@desc Delete an incident record from Incident Manager.\n@required {arn: str}\n\n@endgroup\n\n@group deleteReplicationSet\n@endpoint POST /deleteReplicationSet\n@desc Deletes all Regions in your replication set. Deleting the replication set deletes all Incident Manager data.\n@required {arn: str}\n\n@endgroup\n\n@group deleteResourcePolicy\n@endpoint POST /deleteResourcePolicy\n@desc Deletes the resource policy that Resource Access Manager uses to share your Incident Manager resource.\n@required {policyId: str, resourceArn: str}\n\n@endgroup\n\n@group deleteResponsePlan\n@endpoint POST /deleteResponsePlan\n@desc Deletes the specified response plan. Deleting a response plan stops all linked CloudWatch alarms and EventBridge events from creating an incident with this response plan.\n@required {arn: str}\n\n@endgroup\n\n@group deleteTimelineEvent\n@endpoint POST /deleteTimelineEvent\n@desc Deletes a timeline event from an incident.\n@required {eventId: str, incidentRecordArn: str}\n\n@endgroup\n\n@group getIncidentRecord\n@endpoint GET /getIncidentRecord\n@desc Returns the details for the specified incident record.\n@required {arn: str}\n@returns(200) {incidentRecord: IncidentRecord{arn: str, automationExecutions: [AutomationExecution]?, chatChannel: ChatChannel?{chatbotSns: [str]?, empty: EmptyChatChannel?}, creationTime: str(timestamp), dedupeString: str, impact: int, incidentRecordSource: IncidentRecordSource{createdBy: str, invokedBy: str?, resourceArn: str?, source: str}, lastModifiedBy: str, lastModifiedTime: str(timestamp), notificationTargets: [NotificationTargetItem]?, resolvedTime: str(timestamp)?, status: str, summary: str?, title: str}}\n\n@endgroup\n\n@group getReplicationSet\n@endpoint GET /getReplicationSet\n@desc Retrieve your Incident Manager replication set.\n@required {arn: str}\n@returns(200) {replicationSet: ReplicationSet{arn: str?, createdBy: str, createdTime: str(timestamp), deletionProtected: bool, lastModifiedBy: str, lastModifiedTime: str(timestamp), regionMap: map<str, RegionInfo>: any, status: str}}\n\n@endgroup\n\n@group getResourcePolicies\n@endpoint POST /getResourcePolicies\n@desc Retrieves the resource policies attached to the specified response plan.\n@required {resourceArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {nextToken: str?, resourcePolicies: [ResourcePolicy]}\n\n@endgroup\n\n@group getResponsePlan\n@endpoint GET /getResponsePlan\n@desc Retrieves the details of the specified response plan.\n@required {arn: str}\n@returns(200) {actions: [Action]?, arn: str, chatChannel: ChatChannel?{chatbotSns: [str]?, empty: EmptyChatChannel?}, displayName: str?, engagements: [str]?, incidentTemplate: IncidentTemplate{dedupeString: str?, impact: int, incidentTags: map<str, str>?: any, notificationTargets: [NotificationTargetItem]?, summary: str?, title: str}, integrations: [Integration]?, name: str}\n\n@endgroup\n\n@group getTimelineEvent\n@endpoint GET /getTimelineEvent\n@desc Retrieves a timeline event based on its ID and incident record.\n@required {eventId: str, incidentRecordArn: str}\n@returns(200) {event: TimelineEvent{eventData: str, eventId: str, eventReferences: [EventReference]?, eventTime: str(timestamp), eventType: str, eventUpdatedTime: str(timestamp), incidentRecordArn: str}}\n\n@endgroup\n\n@group listIncidentFindings\n@endpoint POST /listIncidentFindings\n@desc Retrieves a list of the IDs of findings, plus their last modified times, that have been identified for a specified incident. A finding represents a recent application environment change made by an CloudFormation stack creation or update or an CodeDeploy deployment that can be investigated as a potential cause of the incident.\n@required {incidentRecordArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {findings: [FindingSummary], nextToken: str?}\n\n@endgroup\n\n@group listIncidentRecords\n@endpoint POST /listIncidentRecords\n@desc Lists all incident records in your account. Use this command to retrieve the Amazon Resource Name (ARN) of the incident record you want to update.\n@optional {filters: [Filter], maxResults: int, nextToken: str}\n@returns(200) {incidentRecordSummaries: [IncidentRecordSummary], nextToken: str?}\n\n@endgroup\n\n@group listRelatedItems\n@endpoint POST /listRelatedItems\n@desc List all related items for an incident record.\n@required {incidentRecordArn: str}\n@optional {maxResults: int, nextToken: str}\n@returns(200) {nextToken: str?, relatedItems: [RelatedItem]}\n\n@endgroup\n\n@group listReplicationSets\n@endpoint POST /listReplicationSets\n@desc Lists details about the replication set configured in your account.\n@optional {maxResults: int, nextToken: str}\n@returns(200) {nextToken: str?, replicationSetArns: [str]}\n\n@endgroup\n\n@group listResponsePlans\n@endpoint POST /listResponsePlans\n@desc Lists all response plans in your account.\n@optional {maxResults: int, nextToken: str}\n@returns(200) {nextToken: str?, responsePlanSummaries: [ResponsePlanSummary]}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{resourceArn}\n@desc Lists the tags that are attached to the specified response plan or incident.\n@required {resourceArn: str}\n@returns(200) {tags: map<str,str>}\n\n@endgroup\n\n@group listTimelineEvents\n@endpoint POST /listTimelineEvents\n@desc Lists timeline events for the specified incident record.\n@required {incidentRecordArn: str}\n@optional {filters: [Filter], maxResults: int, nextToken: str, sortBy: str, sortOrder: str}\n@returns(200) {eventSummaries: [EventSummary], nextToken: str?}\n\n@endgroup\n\n@group putResourcePolicy\n@endpoint POST /putResourcePolicy\n@desc Adds a resource policy to the specified response plan. The resource policy is used to share the response plan using Resource Access Manager (RAM). For more information about cross-account sharing, see Cross-Region and cross-account incident management.\n@required {policy: str, resourceArn: str}\n@returns(200) {policyId: str}\n\n@endgroup\n\n@group startIncident\n@endpoint POST /startIncident\n@desc Used to start an incident from CloudWatch alarms, EventBridge events, or manually.\n@required {responsePlanArn: str}\n@optional {clientToken: str, impact: int, relatedItems: [RelatedItem], title: str, triggerDetails: TriggerDetails}\n@returns(200) {incidentRecordArn: str}\n\n@endgroup\n\n@group tags\n@endpoint POST /tags/{resourceArn}\n@desc Adds a tag to a response plan.\n@required {resourceArn: str, tags: map<str,str>}\n\n@endpoint DELETE /tags/{resourceArn}\n@desc Removes a tag from a resource.\n@required {resourceArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group updateDeletionProtection\n@endpoint POST /updateDeletionProtection\n@desc Update deletion protection to either allow or deny deletion of the final Region in a replication set.\n@required {arn: str, deletionProtected: bool}\n@optional {clientToken: str}\n\n@endgroup\n\n@group updateIncidentRecord\n@endpoint POST /updateIncidentRecord\n@desc Update the details of an incident record. You can use this operation to update an incident record from the defined chat channel. For more information about using actions in chat channels, see Interacting through chat.\n@required {arn: str}\n@optional {chatChannel: ChatChannel, clientToken: str, impact: int, notificationTargets: [NotificationTargetItem], status: str, summary: str, title: str}\n\n@endgroup\n\n@group updateRelatedItems\n@endpoint POST /updateRelatedItems\n@desc Add or remove related items from the related items tab of an incident record.\n@required {incidentRecordArn: str, relatedItemsUpdate: RelatedItemsUpdate}\n@optional {clientToken: str}\n\n@endgroup\n\n@group updateReplicationSet\n@endpoint POST /updateReplicationSet\n@desc Add or delete Regions from your replication set.\n@required {actions: [UpdateReplicationSetAction], arn: str}\n@optional {clientToken: str}\n\n@endgroup\n\n@group updateResponsePlan\n@endpoint POST /updateResponsePlan\n@desc Updates the specified response plan.\n@required {arn: str}\n@optional {actions: [Action], chatChannel: ChatChannel, clientToken: str, displayName: str, engagements: [str], incidentTemplateDedupeString: str, incidentTemplateImpact: int, incidentTemplateNotificationTargets: [NotificationTargetItem], incidentTemplateSummary: str, incidentTemplateTags: map<str,str>, incidentTemplateTitle: str, integrations: [Integration]}\n\n@endgroup\n\n@group updateTimelineEvent\n@endpoint POST /updateTimelineEvent\n@desc Updates a timeline event. You can update events of type Custom Event.\n@required {eventId: str, incidentRecordArn: str}\n@optional {clientToken: str, eventData: str, eventReferences: [EventReference], eventTime: str(timestamp), eventType: str}\n\n@endgroup\n\n@end\n"}}