v1

latestOpenAPI 3.0.1Vanta Terms of Service2026-07-26327517821.8 KB

Knowledge Base

Create document resource

Create a document (FILE-type) resource in the Trust Knowledge Base. Accepts the document as a multipart/form-data upload.

Example: send multipart/form-data with a required file (e.g. PDF) and title; optional fields include description, customerVisibility, downloadPermission, isUsedInQuestionnaires ("true"/"false"), expirationDate (ISO 8601), tags (JSON array string), categoryId, and ownerAssignment (JSON object string).

post/knowledge-base/resources/documents

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).