---
title: "POST /batch-update-recommendation-status"
method: POST
path: "/batch-update-recommendation-status"
---

# POST /batch-update-recommendation-status

`POST /batch-update-recommendation-status`

Enables you to include or exclude one or more operational recommendations.

## Request body

- object
  - `appArn` string, required — Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:app/<code>app-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
  - `requestEntries` UpdateRecommendationStatusRequestEntry[], required — Defines the list of operational recommendations that need to be included or excluded.
    - `appComponentId` string — Indicates the identifier of the AppComponent.
    - `entryId` string, required — <p>An identifier for an entry in this batch that is used to communicate the result.</p> <note> <p>The <code>entryId</code>s of a batch request need to be unique within a request.</p> </note>
    - `excludeReason` 'AlreadyImplemented' | 'NotRelevant' | 'ComplexityOfImplementation' — Indicates the reason for excluding an operational recommendation.
    - `excluded` boolean, required — Indicates if the operational recommendation needs to be excluded. If set to True, the operational recommendation will be excluded.
    - `item` object — The operational recommendation item.
      - `resourceId` string — Resource identifier of the operational recommendation item.
      - `targetAccountId` string — Identifier of the target Amazon Web Services account.
      - `targetRegion` string — Identifier of the target Amazon Web Services Region.
    - `referenceId` string, required — Reference identifier of the operational recommendation item.

## Response `200`

Success

- BatchUpdateRecommendationStatusResponse
  - `appArn` string, required — Amazon Resource Name (ARN) of the Resilience Hub application. The format for this ARN is: arn:<code>partition</code>:resiliencehub:<code>region</code>:<code>account</code>:app/<code>app-id</code>. For more information about ARNs, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html"> Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i> guide.
  - `failedEntries` BatchUpdateRecommendationStatusFailedEntry[], required — A list of items with error details about each item, which could not be included or excluded.
    - `entryId` string, required — <p>An identifier of an entry in this batch that is used to communicate the result.</p> <note> <p>The <code>entryId</code>s of a batch request need to be unique within a request.</p> </note>
    - `errorMessage` string, required — Indicates the error that occurred while excluding an operational recommendation.
  - `successfulEntries` BatchUpdateRecommendationStatusSuccessfulEntry[], required — A list of items that were included or excluded.
    - `appComponentId` string — Indicates the identifier of an AppComponent.
    - `entryId` string, required — <p>An identifier for an entry in this batch that is used to communicate the result.</p> <note> <p>The <code>entryId</code>s of a batch request need to be unique within a request.</p> </note>
    - `excludeReason` 'AlreadyImplemented' | 'NotRelevant' | 'ComplexityOfImplementation' — Indicates the reason for excluding an operational recommendation.
    - `excluded` boolean, required — Indicates if the operational recommendation was successfully excluded.
    - `item` object — The operational recommendation item.
      - `resourceId` string — Resource identifier of the operational recommendation item.
      - `targetAccountId` string — Identifier of the target Amazon Web Services account.
      - `targetRegion` string — Identifier of the target Amazon Web Services Region.
    - `referenceId` string, required — Reference identifier of the operational recommendation.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — ValidationException
- `484` — AccessDeniedException

---

[API](https://skmtc.net/aws/apis/resiliencehub.md) · [All operations](https://skmtc.net/aws/apis/resiliencehub/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/resiliencehub/versions/163b82209f70/schema)