POST

/controls

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

Creates a new custom control in Audit Manager.

Access Token Required: API Key

Body Params

namestringrequired

The name of the control.

tagsobject

The tags that are associated with the control.

descriptionstring

The description of the control.

actionPlanTitlestring

The title of the action plan for remediating the control.

testingInformationstring

The steps to follow to determine if the control is satisfied.

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 POST \
2     --url 'http://auditmanager.{region}.amazonaws.com/controls' \
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}