Upload Document
POST/v1/documents/upload
Upload a document directly to a collection.
Provide either collection_id or collection_name. If only collection_name
is given, the system resolves it to a single collection — errors if zero or
multiple matches are found.
Processing statuses:
uploading: Initial state during uploadqueued: Waiting for processingprocessing: Currently being processedready: Available for search and retrievalfailed: Processing failed (can retry)upload_failed_duplicate_content: Duplicate content detected
Allowed file formats:
.pdf,.doc,.docx,.txt,.md,.markdown,.json,.xml,.csv,.tsv,.xls,.xlsm,.xlsx,.pptx,.ppt,.jpg,.jpeg,.png,.html
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 500
Document upload initiated successfully
Authentication failed - Invalid or missing credentials
Permission denied - Insufficient privileges
Resource not found
Validation error - Invalid request data
Internal server error