v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB

Knowledge Base

Replace document resource file

Replace the underlying file on a document (FILE-type) resource with a new multipart upload. Other resource fields (title, description, visibility, tags, owner, etc.) are unchanged — use PATCH for those. Returns 404 for an unknown id or a URL-type resource.

Example: send multipart/form-data with a single file field (the new document binary).

post/knowledge-base/resources/documents/{id}/upload

Path parameters

idstring required

Response

idstring required

type'FILE' required

titlestring required

descriptionstring nullable required

fileUrlstring required

Presigned S3 URL for the underlying document. Expires after 1 hour due to AWS IAM Role limitations on presigned URL lifetimes. Re-fetch the resource to obtain a fresh URL once this one expires.

customerVisibility'PRIVATE' | 'SHAREABLE' | 'REQUEST_ACCESS' | 'PUBLIC' | 'null' nullable required

downloadPermission'VIEW_ONLY' | 'VIEW_AND_DOWNLOAD' | 'null' nullable required

isUsedInQuestionnairesboolean nullable required

expirationStatus'CURRENT' | 'EXPIRED' required

Customer-facing expiration status used by knowledge-base API responses (answer library entries and resources). Derived from the persisted expiresAt field at read time.

expirationDatestring nullable required

lastUpdatedstring required

lastVerifiedstring nullable required

categoryIdstring nullable required

Trust Center category id the resource is currently filed under, or null if uncategorized (or not on the Trust Center, which is the case for PRIVATE / SHAREABLE resources).