v6

latestOpenAPI 3.0.1raw.githubusercontent.com2026-08-0182128753.1 KB

Files

Upload File

Available for: Chatflow, Workflow, New Agent, 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.

post/files/upload

Response

File uploaded successfully.

idstring uuid

Unique file ID.

referencestring nullable

Opaque file reference used internally when attaching files in agent and tool contexts. Always null for files uploaded through this endpoint.

namestring

File name.

sizeinteger

File size in bytes.

extensionstring nullable

File extension.

mime_typestring nullable

MIME type of the file.

created_bystring uuid nullable

End-user ID of the uploader. Look up details with Get End User Info.

created_atinteger

Upload timestamp (Unix epoch seconds).

preview_urlstring nullable

Preview URL for the file.

source_urlstring

Signed URL for downloading the file.

original_urlstring nullable

Original URL of the file.

user_idstring uuid nullable

Unused; always null.

tenant_idstring uuid nullable

ID of the associated tenant.

conversation_idstring uuid nullable

ID of the associated conversation.

file_keystring nullable

Unused; always null.