Own AWS? Customize your docs with AI search, analytics, and more.

PATCH

/insights/{InsightArn}

http://securityhub.{region}.amazonaws.com/insights/{InsightArn}

Updates the Security Hub insight identified by the specified insight ARN.

Access Token Required: API Key

Path Parameters

InsightArnstringrequired

The ARN of the insight that you want to update.

Body Params

Namestring

The updated name for the insight.

Filtersobject

A collection of attributes that are applied to all active Security Hub-aggregated findings and that result in a subset of findings that are included in this insight. You can filter by up to 10 finding attributes. For each attribute, you can provide up to 20 filter values.

GroupByAttributestring

The updated <code>GroupBy</code> attribute that defines this insight.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://securityhub.{region}.amazonaws.com/insights/{InsightArn}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

PATCH

/insights/{InsightArn}

http://securityhub.{region}.amazonaws.com/insights/{InsightArn}

Updates the Security Hub insight identified by the specified insight ARN.

Access Token Required: API Key

Path Parameters

InsightArnstringrequired

The ARN of the insight that you want to update.

Body Params

Namestring

The updated name for the insight.

Filtersobject

A collection of attributes that are applied to all active Security Hub-aggregated findings and that result in a subset of findings that are included in this insight. You can filter by up to 10 finding attributes. For each attribute, you can provide up to 20 filter values.

GroupByAttributestring

The updated <code>GroupBy</code> attribute that defines this insight.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://securityhub.{region}.amazonaws.com/insights/{InsightArn}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

PATCH

/insights/{InsightArn}

http://securityhub.{region}.amazonaws.com/insights/{InsightArn}

Updates the Security Hub insight identified by the specified insight ARN.

Access Token Required: API Key

Path Parameters

InsightArnstringrequired

The ARN of the insight that you want to update.

Body Params

Namestring

The updated name for the insight.

Filtersobject

A collection of attributes that are applied to all active Security Hub-aggregated findings and that result in a subset of findings that are included in this insight. You can filter by up to 10 finding attributes. For each attribute, you can provide up to 20 filter values.

GroupByAttributestring

The updated <code>GroupBy</code> attribute that defines this insight.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://securityhub.{region}.amazonaws.com/insights/{InsightArn}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

PATCH

/insights/{InsightArn}

http://securityhub.{region}.amazonaws.com/insights/{InsightArn}

Updates the Security Hub insight identified by the specified insight ARN.

Access Token Required: API Key

Path Parameters

InsightArnstringrequired

The ARN of the insight that you want to update.

Body Params

Namestring

The updated name for the insight.

Filtersobject

A collection of attributes that are applied to all active Security Hub-aggregated findings and that result in a subset of findings that are included in this insight. You can filter by up to 10 finding attributes. For each attribute, you can provide up to 20 filter values.

GroupByAttributestring

The updated <code>GroupBy</code> attribute that defines this insight.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PATCH \
2     --url 'http://securityhub.{region}.amazonaws.com/insights/{InsightArn}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}