---
title: "POST /audit/mitigationactions/tasks/{taskId}"
method: POST
path: "/audit/mitigationactions/tasks/{taskId}"
---

# POST /audit/mitigationactions/tasks/{taskId}

`POST /audit/mitigationactions/tasks/{taskId}`

Starts a task that applies a set of mitigation actions to the specified target.

Requires permission to access the [StartAuditMitigationActionsTask](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `taskId` string, required

## Request body

- object
  - `target` object, required — Used in MitigationActionParams, this information identifies the target findings to which the mitigation actions are applied. Only one entry appears.
    - `auditTaskId` string — If the task will apply a mitigation action to findings from a specific audit, this value uniquely identifies the audit.
    - `findingIds` FindingId[] — If the task will apply a mitigation action to one or more listed findings, this value uniquely identifies those findings.
    - `auditCheckToReasonCodeFilter` object — Specifies a filter in the form of an audit check and set of reason codes that identify the findings from the audit to which the audit mitigation actions task apply.
  - `auditCheckToActionsMapping` object, required — For an audit check, specifies which mitigation actions to apply. Those actions must be defined in your Amazon Web Services accounts.
  - `clientRequestToken` string, required — Each audit mitigation task must have a unique client request token. If you try to start a new task with the same token as a task that already exists, an exception occurs. If you omit this value, a unique client request token is generated automatically.

## Response `200`

Success

- StartAuditMitigationActionsTaskResponse
  - `taskId` string — The unique identifier for the audit mitigation task. This matches the <code>taskId</code> that you specified in the request.

## Other responses

- `480` — InvalidRequestException
- `481` — TaskAlreadyExistsException
- `482` — LimitExceededException
- `483` — ThrottlingException
- `484` — InternalFailureException

---

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