PUT

/controls/{controlId}

http://auditmanager.{region}.amazonaws.com/controls/{controlId}

Updates a custom control in Audit Manager.

Access Token Required: API Key

Path Parameters

controlIdstringrequired

The identifier for the control.

Body Params

namestringrequired

The name of the updated control.

descriptionstring

The optional description of the control.

actionPlanTitlestring

The title of the action plan for remediating the control.

testingInformationstring

The steps that you should follow to determine if the control is met.

controlMappingSourcesarrayrequired

The data mapping sources for the control.

actionPlanInstructionsstring

The recommended actions to carry out if the control isn't fulfilled.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request PUT \
2     --url 'http://auditmanager.{region}.amazonaws.com/controls/{controlId}' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}