Skip to main content

​
Supported Formats

TypeExtensionsMax Size
Documents.pdf, .docx, .txt, .csv, .json, .md50 MB
Images.png, .jpg, .jpeg, .gif, .webp20 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:
StatusDescription
processingFile is being analyzed
readyFile is ready for use
failedProcessing 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.

Datasets

Add files to datasets

Billing

Storage limits and pricing