---
title: "POST /audit/report-jobs/{reportPlanName}"
method: POST
path: "/audit/report-jobs/{reportPlanName}"
---

# POST /audit/report-jobs/{reportPlanName}

`POST /audit/report-jobs/{reportPlanName}`

Starts an on-demand report job for the specified report plan.

## Path parameters

- `reportPlanName` string, required

## Request body

- object
  - `IdempotencyToken` string — A customer-chosen string that you can use to distinguish between otherwise identical calls to <code>StartReportJobInput</code>. Retrying a successful request with the same idempotency token results in a success message with no action taken.

## Response `200`

Success

- StartReportJobOutput
  - `ReportJobId` string — The identifier of the report job. A unique, randomly generated, Unicode, UTF-8 encoded string that is at most 1,024 bytes long. The report job ID cannot be edited.

## Other responses

- `480` — InvalidParameterValueException
- `481` — ServiceUnavailableException
- `482` — MissingParameterValueException
- `483` — ResourceNotFoundException

---

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