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