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.