v1

latestOpenAPI 3.0.1Apache 2.02026-07-1398228598.3 KB

Knowledge Base

Request KB Source Upload URL

Creates a KB source record and returns a presigned S3 PUT URL for file upload. After uploading the file, call confirm-upload to validate and trigger indexing. Supported file types: PDF, Markdown, HTML, plain text. Maximum file size: 100 MB.

post/knowledge-base/sources/upload

Request body

titlestring

Title of the KB source. Optional — if omitted, the server attempts to extract the title from PDF metadata, falling back to 'Untitled upload'.

Example request

{
  "title": "Competitive Analysis 2025.pdf"
}

Response

Upload URL generated successfully

source_idstring

UUID of the created KB source

upload_urlstring

Presigned S3 PUT URL for uploading the file

Example response

{
  "source_id": "f7e8d9c0-b1a2-3456-7890-abcdef123456",
  "upload_url": "https://s3.amazonaws.com/bucket/kb-sources/org-uuid/source-uuid?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}