Upload external evidence document by control id

Upload external evidence to map to a control

Securitybearer
Request
path Parameters
id
required
number
workspaceId
required
number

The Workspace ID associated to the Account

Request Body schema:
required
file
string <binary>

Accepted file extensions: .pdf, .docx, .odt, .xlsx, .ods, .pptx, .odp, .gif, .jpeg, .jpg, .png

url
string <= 768 characters

The url to the evidence

filename
string <= 191 characters

The name of the evidence

base64File
object

External evidence in Base64 format. Example: {"base64String":"data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg","filename":"excellent-filename"}

description
string <= 30000 characters

The description of the evidence

creationDate
required
string <date-time>

Creation date

renewalDate
required
string

Report renewal date

renewalScheduleType
required
string

The renewal date schedule type of report

Enum: "ONE_MONTH" "TWO_MONTHS" "THREE_MONTHS" "SIX_MONTHS" "ONE_YEAR" "CUSTOM" "NONE"
Responses
201

Record created!

400

Malformed data and/or validation errors

401

Invalid Authorization

403

You are not allowed to perform this action

404

Record Not Found

413

The file was too large to upload

500

Internal server error

503

Third party system was unavailable

default

Response Code: 412

You must accept the Drata terms and conditions to use the API

post/workspaces/{workspaceId}/controls/{id}/external-evidence
Request samples
No sample
Response samples
application/json
{
  • "id": "123",
  • "slug": "databases-monitored-and-alarmed",
  • "externalEvidence": "ExternalEvidenceResponseDto[]"
}