---
title: "POST /assessments/{assessmentId}/reports"
method: POST
path: "/assessments/{assessmentId}/reports"
---

# POST /assessments/{assessmentId}/reports

`POST /assessments/{assessmentId}/reports`

Creates an assessment report for the specified assessment.

## Path parameters

- `assessmentId` string, required

## Request body

- object
  - `name` string, required — The name of the new assessment report.
  - `description` string — The description of the assessment report.
  - `queryStatement` string — <p>A SQL statement that represents an evidence finder query.</p> <p>Provide this parameter when you want to generate an assessment report from the results of an evidence finder search query. When you use this parameter, Audit Manager generates a one-time report using only the evidence from the query output. This report does not include any assessment evidence that was manually <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/generate-assessment-report.html#generate-assessment-report-include-evidence">added to a report using the console</a>, or <a href="https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_BatchAssociateAssessmentReportEvidence.html">associated with a report using the API</a>. </p> <p>To use this parameter, the <a href="https://docs.aws.amazon.com/audit-manager/latest/APIReference/API_EvidenceFinderEnablement.html#auditmanager-Type-EvidenceFinderEnablement-enablementStatus">enablementStatus</a> of evidence finder must be <code>ENABLED</code>. </p> <p> For examples and help resolving <code>queryStatement</code> validation exceptions, see <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/evidence-finder-issues.html#querystatement-exceptions">Troubleshooting evidence finder issues</a> in the <i>Audit Manager User Guide.</i> </p>

## Response `200`

Success

- CreateAssessmentReportResponse
  - `assessmentReport` object — The new assessment report that the <code>CreateAssessmentReport</code> API returned.
    - `id` string — The unique identifier for the assessment report.
    - `name` string — The name that's given to the assessment report.
    - `description` string — The description of the specified assessment report.
    - `awsAccountId` string — The identifier for the specified Amazon Web Services account.
    - `assessmentId` string — The identifier for the specified assessment.
    - `assessmentName` string — The name of the associated assessment.
    - `author` string — The name of the user who created the assessment report.
    - `status` 'COMPLETE' | 'IN_PROGRESS' | 'FAILED' — The current status of the specified assessment report.
    - `creationTime` string, date-time — Specifies when the assessment report was created.

## Other responses

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

---

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