POST

/assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}/evidence

http://auditmanager.{region}.amazonaws.com/assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}/evidence

Uploads one or more pieces of evidence to a control in an Audit Manager assessment. You can upload manual evidence from any Amazon Simple Storage Service (Amazon S3) bucket by specifying the S3 URI of the evidence. You must upload manual evidence to your S3 bucket before you can upload it to your assessment. For instructions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html">PutObject</a> in the Amazon Simple Storage Service API Reference. The following restrictions apply to this action: <ul> <li> Maximum size of an individual evidence file: 100 MB </li> <li> Number of daily manual evidence uploads per control: 100 </li> <li> Supported file formats: See <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/upload-evidence.html#supported-manual-evidence-files">Supported file types for manual evidence</a> in the Audit Manager User Guide </li> </ul> For more information about Audit Manager service restrictions, see <a href="https://docs.aws.amazon.com/audit-manager/latest/userguide/service-quotas.html">Quotas and restrictions for Audit Manager</a>.

Access Token Required: API Key

Path Parameters

assessmentIdstringrequired

The identifier for the assessment.

controlSetIdstringrequired

The identifier for the control set.

controlIdstringrequired

The identifier for the control.

Body Params

manualEvidencearrayrequired

The list of manual evidence objects.

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/assessments/{assessmentId}/controlSets/{controlSetId}/controls/{controlId}/evidence' \
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}