Skip to main content
Upload one or more files to an existing chat session. Supported file types include documents, presentations, spreadsheets, and images.
chat_id is now required. Call Create Chat first to obtain one — uploads without chat_id return 400 MISSING_CHAT_ID, and an unknown ID returns 404 Chat not found.
Uploaded files are processed server-side: documents are parsed and chunked for retrieval, images are captioned and embedded. After uploading, reference the returned upload IDs in a WebSocket send_message request to attach them to a conversation turn.
This endpoint is rate-limited to 30 requests per minute per authenticated member. Re-authenticating does not reset the bucket. Excess requests return 429 with a Retry-After header.
string
required
Bearer token obtained from the authenticate endpoint.
file[]
required
One or more files to upload. Sent as multipart/form-data. Maximum 5 files per request, each up to 30 MB.The multipart MIME type, detected file content, and filename extension must agree:Declare an allowed MIME type on every multipart file part. A valid file sent as application/octet-stream, or with a mismatched extension, is rejected. The current unsupported-file error message names only five common formats; the table above is the complete allowlist.
string
required
ID of an existing chat to attach the files to. Obtain one from Create Chat.

Response

string
required
The existing chat the files were uploaded to.
array
required
List of successfully processed uploads.