Uploads a document to the Knowledge Base (excluding type "url"). Limit is one file per call.

📘

All requests to any Knowledge Base APIs require a Dialog Manager API Key.

To obtain this key, go to the Integration tab on the project you uploaded data sources to and click the "Copy API key" button.

Request Fields

PropertyDescription & Example
Authorization
(header)
Dialog Manager API Key
Content-Type
(header)
multipart/form-data
overwrite
(query parameter)
Optional - Specify whether to overwrite existing data (optional).
"True" means you want to overwrite.
maxChunkSize
(query parameter)
Optional - Determine how granularly each document is broken up.
Max chunk size affects the total amount of chunks parsed from a document.
(i.e. larger chunks means less chunks retrieved)

Smaller chunk size means:
- narrower context
- faster response
- less tokens consumed
- greater risk of less accurate answers

type: integer ; default: 1000; Range available is 500-1500 tokens.
Once uploaded, you can view the chunks using the GET Document Chunk Retrieval Knowledge Base API.
file
(body, form-data)
Accepted source document types for this endpoint are:
pdf, text, or docx.

Example

Sample Route with query parameters:

https://api.voiceflow.com/v3alpha/knowledge-base/docs/upload?tags=["beginner"]

Sample Response

{
  	"data": {
			"documentID": "6515dccab4bc5400060fbc6a",
			"data": {
				"type": "pdf",
				"name": "Learn-to-Sail.pdf"
			},
			"updatedAt": "2023-09-28T20:06:34.049Z",
			"status": {
				"type": "PENDING"
			},
			"tags": [
				"beginner"
			]
		}
}
Language
Authorization
Header
Click Try It! to start a request and see the response here!