# upload_file

Upload an image or video file from a URL for use as workflow input.

Returns a file\_id to pass as input to workflows or forge runs. Upload files before  
executing a generation — uploaded files can be reused across multiple runs.

IMPORTANT: Call tool \`get\_instructions\` first for general platform guidance.

## Parameters

| Parameter             | Type          | Default | Description                                                                                                  |
| --------------------- | ------------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| workspace\_idrequired | string (uuid) | —       | The user's workspace id.                                                                                     |
| urlrequired           | string        | —       | Public URL of the image or video file to upload.                                                             |
| content\_type         | string        | —       | MIME type of the file (e.g. image/png, video/mp4). Optional — auto-detected from URL extension when omitted. |