Skip to main content

Upload 1–50 files (multipart); each file gets its own result

POST 

/v1/knowledge_bases/:kb_id/documents

Durable acceptance (202), not completion: accepted files continue uploaded → validating → queued → processing → ready. Per-file checks (size, extension/MIME/signature, duplicate content, remaining capacity) reject individual files without affecting the others. Request-level failures (authentication, knowledge-base state, too many files, request too large, maintenance, a trial or billing refusal for the whole request) return an error status instead.

Access: API key scope knowledge:write; portal users: organization admins and owners; the knowledge base in the path must be on the key's access list; refused with 503 maintenance_mode during maintenance; refused with 403 module_disabled while knowledge bases are switched off on the platform.

Request​

Responses​

Per-file results.