---
title: "POST /v2/update-failure-mode-finding"
method: POST
path: "/v2/update-failure-mode-finding"
---

# POST /v2/update-failure-mode-finding

`POST /v2/update-failure-mode-finding`

Updates an existing finding.

## Request body

- object
  - `findingId` string, required — The identifier of the finding to update.
  - `status` 'OPEN' | 'RESOLVED' | 'IRRELEVANT', required — The new status for the finding.
  - `serviceArn` string, required — ARN identifier.
  - `comment` string — A comment about the finding update.

## Response `200`

Success

- UpdateFailureModeFindingResponse
  - `finding` object — The updated finding.
    - `findingId` string — The unique identifier of the finding.
    - `name` string — The name of the finding.
    - `description` string — Resource description.
    - `failureCategory` 'SHARED_FATE' | 'EXCESSIVE_LOAD' | 'EXCESSIVE_LATENCY' | 'MISCONFIGURATION_AND_BUGS' | 'SINGLE_POINT_OF_FAILURE' — The failure category of the finding.
    - `status` 'OPEN' | 'RESOLVED' | 'IRRELEVANT' — The current status of the finding.
    - `reasoning` string — The reasoning behind the finding.
    - `comment` string — A user-provided comment about the finding.
    - `severity` 'LOW' | 'MEDIUM' | 'HIGH' — The severity of the finding.
    - `serviceFunctions` EntityId[] — The service functions associated with the finding.
    - `policyComponent` 'AVAILABILITY_SLO' | 'MULTI_AZ_DISASTER_RECOVERY' | 'MULTI_REGION_DISASTER_RECOVERY' | 'DATA_RECOVERY' — The policy component associated with the finding.
    - `infrastructureAndCodeRecommendations` InfrastructureAndCodeRecommendation[] — Infrastructure and code recommendations to address the finding.
      - `suggestedChanges` EntityDescription[] — The list of suggested changes.
    - `observabilityRecommendations` ObservabilityRecommendation[] — Observability recommendations to address the finding.
      - `suggestedChanges` EntityDescription[] — The list of suggested observability changes.
    - `testingRecommendations` TestingRecommendation[] — Testing recommendations to address the finding.
      - `suggestedChanges` EntityDescription[] — The list of suggested testing changes.
    - `updatedAt` string, date-time — The timestamp when the finding was last updated.

## Other responses

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

---

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