Complete an auditor file upload and attach the file
Completes an auditor file upload by validating the file and attaching it
to the information request. First start an upload with
POST /v1/audits/{auditId}/information-requests/{requestId}/auditor-files/uploads,
then transfer the file to the returned url and wait for its 2xx response.
Calling finalize before the file arrives ends that upload; start a new one.
Send { "uploadId": "<returned uploadId>" } using the same application,
audit and information request that started the upload. Vanta uses the
auditor identified by email at the start; that auditor must still be an
active user in your firm with audit access. Unsupported file types return
422 during finalization.
A 201 response contains the attached file’s id, which differs from
uploadId. Use GET /v1/audits/{auditId}/information-requests/{requestId}/auditor-files
to find that ID and obtain a temporary download URL.
Retry the same upload ID with backoff after a lost response, a 5xx or a 429.
Stop retrying at finalizationExpiresAt. A 409 means the audit is
completed; stop this attempt. For 404, 413 or 422, stop this attempt and
correct the input or start a new upload.
A 429 can mean too many requests, another finalization of this upload is still running, or too many files are being finalized for this application and customer. After a failed attempt, you may need to wait up to 60 seconds before retrying. Expired uploads, missing files and unsupported files return 422; files over 50MB return 413. Retrying a finalization that already succeeded returns the original auditor file ID, even if the file was later deleted; it does not attach the file again. Current access is still required.
Rate limit: 10 requests / minute.