| Type | Extensions | Max Size |
|---|
| Documents | .pdf, .docx, .txt, .csv, .json, .md | 50 MB |
| Images | .png, .jpg, .jpeg, .gif, .webp | 20 MB |
Quick Start
curl -X POST https://api.cuadra.ai/v1/files \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Idempotency-Key: upload-001" \
-F "file=@document.pdf"
Processing Status
Files are processed asynchronously after upload:
| Status | Description |
|---|
processing | File is being analyzed |
ready | File is ready for use |
failed | Processing failed |
Poll GET /v1/files/{file_id} to check processing status, or use webhooks for async notification.
Associating with Datasets
After upload, associate files with a dataset to make them searchable:
curl -X POST https://api.cuadra.ai/v1/files/file_abc123/associations \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"datasetId": "ds_xyz789"}'
Storage Limits
Storage limits depend on your plan. See cuadra.ai/pricing for details.
Files referenced by datasets cannot be deleted until removed from all datasets.
