remove unused url parameter from /files/upload

The experimental url query parameter was never used by any consumer.
Open WebUI uses multipart file uploads exclusively. The endpoint now
only accepts direct file uploads, and the file parameter is required
instead of optional.

Author: tjbck

CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.11.16] - 2026-03-13
+
+### Removed
+
+- 🧹 **Removed experimental `url` parameter from `/files/upload`** — this feature was never used by any known consumer (Open WebUI uses multipart uploads). The endpoint now only accepts direct file uploads.
+
 ## [0.11.15] - 2026-03-13
 
 ### Changed

open_terminal/main.py

@@ -851,39 +851,21 @@ def _glob_sync():
     include_in_schema=False,
     operation_id="upload_file",
     summary="Upload a file",
-    description="Save a file to the specified path. Provide a `url` to fetch remotely, or send the file directly via multipart form data.",
+    description="Save a file to the specified path via multipart form data.",
     dependencies=[Depends(verify_api_key)],
     responses={
         401: {"description": "Invalid or missing API key."},
     },
 )
 async def upload_file(
     directory: str = Query(..., description="Destination directory for the file."),
-    url: Optional[str] = Query(
-        None,
-        description="URL to download the file from. If omitted, expects a multipart file upload.",
-    ),
-    file: Optional[UploadFile] = File(
-        None, description="The file to upload (if no URL provided)."
+    file: UploadFile = File(
+        ..., description="The file to upload."
     ),
     fs: UserFS = Depends(get_filesystem),
 ):
-    if url:
-        import httpx
-        from urllib.parse import urlparse
-
-        async with httpx.AsyncClient(follow_redirects=True) as client:
-            response = await client.get(url)
-            response.raise_for_status()
-        content = response.content
-        filename = os.path.basename(urlparse(url).path) or "download"
-    elif file:
-        content = await file.read()
-        filename = os.path.basename(file.filename or "upload")
-    else:
-        raise HTTPException(
-            status_code=400, detail="Provide either 'url' or a file upload."
-        )
+    content = await file.read()
+    filename = os.path.basename(file.filename or "upload")
 
     directory = fs.resolve_path(directory)
     path = os.path.normpath(os.path.join(directory, filename))

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "open-terminal"
-version = "0.11.15"
+version = "0.11.16"
 description = "A remote terminal API."
 readme = "README.md"
 authors = [