---
title: "PUT /assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}"
method: PUT
path: "/assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}"
---

# PUT /assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}

`PUT /assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}`

Updates a control within an assessment in Audit Manager.

## Path parameters

- `assessmentId` string, required
- `controlSetId` string, required
- `controlId` string, required

## Request body

- object
  - `controlStatus` 'UNDER_REVIEW' | 'REVIEWED' | 'INACTIVE' — The status of the control.
  - `commentBody` string — The comment body text for the control.

## Response `200`

Success

- UpdateAssessmentControlResponse
  - `control` object — The name of the updated control set that the <code>UpdateAssessmentControl</code> API returned.
    - `id` string — The identifier for the control.
    - `name` string — The name of the control.
    - `description` string — The description of the control.
    - `status` 'UNDER_REVIEW' | 'REVIEWED' | 'INACTIVE' — The status of the control.
    - `response` 'MANUAL' | 'AUTOMATE' | 'DEFER' | 'IGNORE' — The response of the control.
    - `comments` ControlComment[] — The list of comments that's attached to the control.
      - `authorName` string — The name of the user who authored the comment.
      - `commentBody` string — The body text of a control comment.
      - `postedDate` string, date-time — The time when the comment was posted.
    - `evidenceSources` NonEmptyString[] — The list of data sources for the evidence.
    - `evidenceCount` integer — The amount of evidence that's collected for the control.
    - `assessmentReportEvidenceCount` integer — The amount of evidence in the assessment report.

## Other responses

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

---

[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)