Skip to main content
POST
Complete a chunked upload

Authorizations

Authorization
string
header
required

API key for authentication. Format: gcai_xxxxxxxxx

Create API keys in the GC AI app under Settings → API.

Path Parameters

upload_id
string<uuid>
required

The upload session ID from initiate.

Body

application/json
part_count
integer
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.

Required range: 1 <= x <= 32
Example:

3

Response

File assembled and processing

id
string<uuid>
required

Unique file identifier

name
string
required

Original filename

size
number
required

File size in bytes

content_type
string
required

MIME type of the file

Example:

"application/pdf"

status
enum<string>
required

Current processing status of the file

Available options:
extracting,
embedding,
ready,
failed
created_at
string
required

ISO 8601 creation timestamp

folder_id
string<uuid> | null

Folder the file belongs to

extraction_error
string

Error message if extraction failed

project_id
string<uuid>

Project the file is linked to, if uploaded with project_id

warning
string

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