Skip to main content
A Media Upload gambit shows a dashed upload area reading “Drag files here, or browse”, which also lists the accepted types and the size cap. Picked files collect in a tray, and the end user can add a caption before sending.

​
When to use it

Use it whenever the answer is evidence rather than words: a photo of a damaged item, a receipt, a screenshot of an error, a signed form. Constrain the types so the end user is not offered a file the gambit will refuse.

​
The gambit and its editor

Every page in this section shows the same demo flow: Start, a Welcome message, the gambit this page covers, then End. The gambit sits third, selected, with its editor open on the right. The rest of the screen is dimmed. Media Upload is the one input type with no Conditions section. It always branches on two fixed handles instead: Text path for a typed reply, File path for an upload.

​
Configuration

​
POST Action

The POST Action section runs an API call or custom code once the upload is captured. See Flow control and branching.

​
Reading the result

The upload is captured as the gambit’s answer and appears in the conversation record. Retention and access for uploaded files are covered in File and data protection. When a later AI Agent gambit has the File Reading tool on, the agent can also read the file’s content. See Built-in AI capabilities.