Skip to main content
FilesVersion: 2021-04-15

Uploads a file to knowledge base (max file size: 10MB)

POST/knowledge-bases/files

Uploads a PDF, DOC, or DOCX file (max 10MB) into a knowledge base for training. WHEN TO USE: use this when you need to add a document source; use getFilesByKnowledgeBasePublic to list uploads; use deleteFile to remove a file. Do not use this for website pages — use discoverWebsite / trainDiscoveredUrls. RETURNS: success and the uploaded file url, fileId, and folder path.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:knowledge-bases.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version

Available options2021-04-15
Example:2021-07-28

Body

File upload with metadata

locationIdstring

location id

Example:ocQHyuzHvysMo5N5VsXc
knowledgeBaseIdstringrequired

knowledge base id

Example:ocQHyuzHvysMo5N5VsXc
filestring<binary>required

File to upload (max size: 10MB). Supported formats: PDF, DOC, DOCX

Response

Uploads a file to knowledge base

successbooleanrequired

success

Example:true
dataobjectrequired

details of the uploaded file