Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1461972964.4 KB

Creates a custom insight in Security Hub. An insight is a consolidation of findings that relate to a security issue that requires attention or remediation.

To group the related findings in the insight, use the GroupByAttribute.

post/insights

Request body

Namestring required

The name of the custom insight to create.

GroupByAttributestring required

The attribute used to group the findings for the insight. The grouping attribute identifies the type of item that the insight applies to. For example, if an insight is grouped by resource identifier, then the insight produces a list of resource identifiers.

Response

Success

InsightArnstring required

The ARN of the insight created.

Example response

{
  "InsightArn": "arn:aws:securityhub:us-west-1:123456789012:insight/123456789012/custom/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}