Sign in

v1

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

Create a comment for audit evidence

Create a comment in Vanta for a piece of evidence.

Rate limit: 10 requests / minute.

post/audits/{auditId}/evidence/{auditEvidenceId}/comments

Path parameters

auditIdstring required
auditEvidenceIdstring required

Request body

textstring required

Text value of the comment

emailstring required

Email of author. Must match an existing Vanta user and the user must exist under the Audit Firm who is making the API request

creationDatestring date-time required

When the comment was created in the external system

Response

Ok

idstring required

The unique identifier for the comment

auditEvidenceIdstring required

The unique identifier for the audit evidence related to the comment.

textstring required

The comment message

creationDatestring date-time required

When the comment was created

modificationDatestring date-time nullable required

When the comment was updated

deletionDatestring date-time nullable required

When the comment was deleted

emailstring nullable required

The email of the comment author. This acts as a unique identifier to map users between Vanta and external systems.

authorNamestring nullable required

Human-readable display name of the comment author. Null if the author's name is not available (e.g., user was deleted). This enables correct author attribution in integrations where users cannot be reliably matched across systems by email alone.