Docs API Reference Documents API Documents API Endpoints for uploading files, adding URLs, listing documents, and viewing processing status.
File uploads follow a presigned URL flow : first request a presigned URL from the backend, upload directly to S3, then confirm the upload to trigger processing.
Get a presigned S3 URL for direct file upload.
Request Body Parameter Type Description file_name required string Original file name with extension file_type required string MIME type (e.g., application/pdf)
Response {
"upload_url": "https://s3.amazonaws.com/bucket/...",
"document_id": "uuid",
"s3_key": "user_id/project_id/filename.pdf"
}Confirm file upload and trigger processing pipeline.
Request Body Parameter Type Description document_id required uuid Document ID returned from upload-url s3_key required string S3 key returned from upload-url
Process a web URL — crawls the page and runs the ingestion pipeline.
Request Body Parameter Type Description url required string Public URL to crawl and process
List all documents in a project with their processing status.
Response [
{
"id": "uuid",
"file_name": "research-paper.pdf",
"file_type": "application/pdf",
"status": "completed",
"status_message": null,
"created_at": "2025-01-01T00:00:00Z"
}
]Get detailed information about a specific document, including its chunks.
Path Parameters Parameter Type Description document_id required uuid ID of the document
Delete a document, its chunks, and its S3 file.
Path Parameters Parameter Type Description document_id required uuid ID of the document to delete
