Skip to main content
POST
Create document
This endpoint creates a new document in a knowledgebase. Documents are processed asynchronously - the endpoint returns immediately while processing continues in the background.

Path Parameters

knowledgebaseId
integer
required
The unique identifier of the knowledgebase

Request Body

name
string
required
The name of the document (max 255 characters)
description
string
Optional description of the document (max 255 characters)
type
string
required
Document type: website, pdf, txt, or docx

Website Documents

url
string
The main URL to scrape. Required if links is not provided.
Array of specific URLs to scrape. Required if url is not provided.
Maximum number of relative links to follow when scraping (1-50)

File Documents (PDF, TXT, DOCX)

file
file
required
The file to upload (max 20MB). Use multipart/form-data encoding.

Response

message
string
Success message
data
object
The created document object

Document Types

Example: Creating a Website Document

Example: Uploading a PDF Document

Document processing is asynchronous. Poll the get document endpoint to check when processing is complete.