---
title: "Update audit evidence"
method: PATCH
path: "/audits/{auditId}/evidence/{auditEvidenceId}"
tags: ["Audits"]
---

# Update audit evidence

`PATCH /audits/{auditId}/evidence/{auditEvidenceId}`

Update audit evidence.

Rate limit: 10 requests / minute.

## Path parameters

- `auditId` string, required
- `auditEvidenceId` string, required

## Request body

- AuditEvidenceUpdateInput
  - `statusUpdate` object
    - `auditorEmail` string, required — Email of the auditor who changed the state
    - `stateTransition` 'ACCEPT' | 'MARK_APPLICABLE' | 'FLAG' | 'MARK_NA' | 'READY_FOR_AUDIT', required

## Response `200`

Ok

- Evidence
  - `id` string, required — Vanta internal reference to evidence
  - `externalId` string, required — This is a static UUID to map Audit Firm controls to Vanta controls
  - `status` 'Accepted' | 'Flagged' | 'Initialized' | 'NA' | 'Not ready for audit' | 'Ready for audit', required
  - `name` string, required — Mutable name for evidence. Not guaranteed to be unique.
  - `deletionDate` string, date-time, nullable, required — The date this Audit Evidence was deleted
  - `creationDate` string, date-time, required — The date this Audit Evidence was created
  - `statusUpdatedDate` string, date-time, required — Point in time that status was last updated
  - `testStatus` string, nullable, required — The outcome of the automated test run, for Test-type evidence
  - `evidenceType` 'Evidence Request' | 'Policy' | 'Test', required
  - `evidenceId` string, required — Unique identifier for evidence
  - `relatedControls` EvidenceControl[], required — The controls associated to this evidence
    - `name` string, required — Name of control associated to this evidence
    - `sectionNames` string[], required — A list sections associated to the control
  - `description` string, nullable, required — The description for the evidence. It will be set to null if the evidence is deleted

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/versions/6c1f7590538b/schema)