---
title: "POST /v2/create-report"
method: POST
path: "/v2/create-report"
---

# POST /v2/create-report

`POST /v2/create-report`

On-demand report creation. Idempotent — duplicate requests with same clientToken return existing result.

## Request body

- object
  - `serviceArn` string, required — ARN identifier.
  - `reportType` 'FAILURE_MODE', required — The type of report to generate.
  - `clientToken` string — Idempotency token.

## Response `200`

Success

- CreateReportResponse
  - `reportGenerationResult` object, required — The result of the report generation request.
    - `reportType` 'FAILURE_MODE', required — The type of the generated report.
    - `status` 'PENDING' | 'SUCCEEDED' | 'FAILED', required — The status of the report generation.
    - `serviceArn` string — The service this report was generated for.
    - `assessmentId` string — Present for FAILURE_MODE reports.
    - `createdAt` string, date-time — The timestamp when the report was created.
    - `reportOutput` object — Present when status is SUCCEEDED or FAILED.
      - `s3ReportOutput` object — The S3 location where the report was written.
        - `s3ObjectKey` string, required — The S3 object key for the generated report.
      - `failedReportOutput` object — Details when report generation failed.
        - `errorCode` 'INSUFFICIENT_PERMISSIONS' | 'CONFIGURATION_ERROR' | 'INTERNAL_ERROR', required — The error code describing why the report generation failed.
        - `errorMessage` string — The error message describing why the report generation failed.

## Other responses

- `480` — InternalServerException
- `481` — ResourceNotFoundException
- `482` — ValidationException
- `483` — ConflictException
- `484` — ThrottlingException
- `485` — 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)