Upload document files

POST /document-intelligence/v1/collections/{collection_id}/documents/files

Upload one or more files whose bytes live on local disk, as multipart/form-data under the field name files. Use this when a document is not already reachable at a URL - otherwise POST /documents with file_url is cheaper, because the bytes never pass through the API.

Answers 202 with a job_id covering the whole upload; poll it for progress. Metered against the ingestion rate limit. Send an Idempotency-Key header so a retry does not ingest the same files twice.

Parameters

Name	In	Required	Notes
collection_id	path	yes	-

Example

curl -X POST "https://api.futuresmart.ai/document-intelligence/v1/collections/{collection_id}/documents/files" \
  -H "Authorization: Bearer $FS_API_KEY"

Responses

202

Field	Type	Required	Notes
job_id	string	yes	-
collection_id	string	yes	-
status	string	yes	-
document_count	integer	yes	-

Every failure, a malformed request included, comes back in the shared envelope with a stable code to branch on. See Errors.