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.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.