AimableDocs
DocsAPI Reference
POST/v1/files/

Ingest Files

Ingest multiple files into the document store. Supported formats: CSV, DOCX, HTML, JSON, MD, PPTX, PDF, TXT, XLSX When ``thread_id`` is provided, the upload is routed to a per-thread collection (lazily created), so files attached inside a chat stay scoped to that conversation. Without ``thread_id``, files land in the caller's personal collection (the ``/chat/files`` surface). When ``space_id`` is provided and the target space has ``include_full_file_content=True``, the request is validated against the aggregate full-file budget. ``existing_source_ids`` is a JSON-encoded list of source_ids already attached to the in-progress chat turn — the server sums their extracted sidecar sizes plus the new uploads' and rejects with 413 if the total exceeds ``FULL_FILE_MAX_TOTAL_CHARS`` or the count exceeds ``FULL_FILE_MAX_DOCS``.

Headers

NameTypeRequiredDescription
X-API-KeystringOptional

Request

curl -X POST '/api-proxy/v1/files/' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

Response

200

No response body documented

Error Responses