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

integer
required
The unique identifier of the knowledgebase

Request Body

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

Website Documents

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
required
The file to upload (max 20MB). Use multipart/form-data encoding.

Response

string
Success message
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.