v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB
Audits

Create a custom evidence request for an audit

Create a custom evidence request for an audit.

Rate limit: 10 requests / minute.

post/audits/{auditId}/evidence/custom-evidence-requests

Path parameters

auditIdstring required

Request body

controlIdsstring[] required

A set of controls, referenced by id, to map the evidence to

titlestring required

Title for the evidence request

descriptionstring required

Description for the evidence request

cadence'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y' required
reminderWindow'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y' required
isRestrictedboolean required

Whether this document contains sensitive data and needs more restrictive read access

auditorEmailstring required

Email of the auditor who created the custom evidence request.

Response

Ok

idstring required

Internal id of the custom evidence request within Vanta

controlIdsstring[] required

A set of controls, referenced by id, to map the evidence to

titlestring required

Title for the evidence request

descriptionstring required

Description for the evidence request

cadence'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y' required
reminderWindow'P0D' | 'P1D' | 'P1W' | 'P1M' | 'P3M' | 'P6M' | 'P1Y' | 'P2Y' required
isRestrictedboolean required

Whether this document contains sensitive data and needs more restrictive read access