CAI APIAPI Reference

File Upload

CAI ingests files via direct upload.

Direct upload (multipart)

Endpoint: POST /api/v1/documents/upload

curl -X POST "$CAI_BASE_URL/api/v1/documents/upload?project_id=$CAI_PROJECT_ID" \
  -H "Authorization: Bearer $CAI_TOKEN" \
  -F "files=@/path/to/report.pdf"

The response includes file_key for each uploaded file.

File operations

  • List files: GET /api/v1/documents/list
  • Download file: GET /api/v1/documents/{file_key}/download
  • Download scan: GET /api/v1/documents/{file_key}/scan
  • Delete file: DELETE /api/v1/documents/{file_key}
curl -H "Authorization: Bearer $CAI_TOKEN" \
  "$CAI_BASE_URL/api/v1/documents/list?project_id=$CAI_PROJECT_ID"