VAvanta
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

Request

Path parameters

idstring required

Request body multipart/form-data

filestring binary required

New document binary; replaces the existing file in place.

Response

Ok

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

Changes

No recorded changes to this operation across all 1 revision of this API.