Upload File
Available for: Chatflow, Workflow, Chatbot, Agent, Text Generator apps.
Uploads a file and returns its id for later requests to reference. The file belongs to the uploading end user: only requests carrying the same user can reference it.
Which file types an app actually consumes depends on its file-upload settings; read them from Get App Parameters.
Authorizations
Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).
Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).
Body
File upload request. Requires multipart/form-data.
The file to upload, as one multipart/form-data part. The filename must not contain / or \.
Any extension is accepted unless it is on the deployment's security blacklist (UPLOAD_FILE_EXTENSION_BLACKLIST, empty by default).
Size limits per category: images 10 MB, audio 50 MB, video 100 MB, other files 15 MB by default; deployments may override them via the UPLOAD_*_FILE_SIZE_LIMIT environment variables.
End-user identifier this upload belongs to, defined by your app and unique within it. Omit it to attribute the upload to the shared DEFAULT-USER. Only later requests with the same user can reference the file. See End User Identity.
Response
File uploaded successfully.
Unique file ID.
Opaque file reference used internally when attaching files in agent and tool contexts. Always null for files uploaded through this endpoint.
File name.
File size in bytes.
File extension.
MIME type of the file.
End-user ID of the uploader. Look up details with Get End User Info.
Upload timestamp (Unix epoch seconds).
Preview URL for the file.
Signed URL for downloading the file.
Original URL of the file.
Unused; always null.
ID of the associated tenant.
ID of the associated conversation.
Unused; always null.