Files

Complete a chunked upload

Assemble the uploaded parts into the final file and start processing (text extraction, summarization, embeddings), returning the same file object as POST /files. For PDFs and Word documents, extraction runs asynchronously; poll GET /files/{id} until status is ready.

post/files/uploads/{upload_id}/complete

Request

Path parameters

upload_idstring uuid required

The upload session ID from initiate.

Request body

part_countinteger required

The total number of parts you uploaded. Parts must be a contiguous run from 1 to this value; completion fails if any are missing.

Example request

{
  "part_count": 3
}

Response

File assembled and processing

idstring uuid required

Unique file identifier

namestring required

Original filename

sizenumber required

File size in bytes

content_typestring required

MIME type of the file

status'extracting' | 'embedding' | 'ready' | 'failed' required

Current processing status of the file

created_atstring required

ISO 8601 creation timestamp

folder_idstring uuid nullable

Folder the file belongs to

extraction_errorstring

Error message if extraction failed

project_idstring uuid

Project the file is linked to, if uploaded with project_id

warningstring

Present when the file was uploaded successfully but a secondary operation (e.g. project linking) failed

Example response

{
  "content_type": "application/pdf"
}

Changes

No recorded changes to this operation across all 1 revision of this API.