diff --git a/api-reference/openapi/content.json b/api-reference/openapi/content.json
index 09c2a710..cf7dd9b9 100644
--- a/api-reference/openapi/content.json
+++ b/api-reference/openapi/content.json
@@ -358,6 +358,56 @@
         }
       }
     },
+    "/api/sandboxes/staged-file": {
+      "post": {
+        "description": "Issue a presigned upload token so the browser can upload a file directly to Vercel Blob, then call `POST /api/sandboxes/files` with the resulting blob URL to commit it to the sandbox repo. Use `upload()` from `@vercel/blob/client` rather than calling this route by hand. Max file size 100MB.",
+        "requestBody": {
+          "description": "`HandleUploadBody` envelope from `@vercel/blob/client`.",
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "additionalProperties": true
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Handshake response from `@vercel/blob/client` — return verbatim to the library.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": true
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Missing or invalid auth on the handshake POST.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SandboxErrorResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Invalid body or upstream Vercel Blob failure.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SandboxErrorResponse"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     "/api/sandboxes/files": {
       "post": {
         "description": "Upload one or more files to the authenticated account's sandbox GitHub repository. Accepts an array of file URLs and commits each file to the specified directory path within the repository. Supports submodule resolution — if the target path falls within a git submodule, the file is committed to the submodule's repository. Authentication is handled via the x-api-key header or Authorization Bearer token.",
diff --git a/api-reference/sandboxes/file.mdx b/api-reference/sandboxes/get-file.mdx
similarity index 100%
rename from api-reference/sandboxes/file.mdx
rename to api-reference/sandboxes/get-file.mdx
diff --git a/api-reference/sandboxes/stage-file.mdx b/api-reference/sandboxes/stage-file.mdx
new file mode 100644
index 00000000..00ff9f34
--- /dev/null
+++ b/api-reference/sandboxes/stage-file.mdx
@@ -0,0 +1,4 @@
+---
+title: 'Stage File'
+openapi: "/api-reference/openapi/content.json POST /api/sandboxes/staged-file"
+---
diff --git a/api-reference/sandboxes/upload.mdx b/api-reference/sandboxes/upload-files.mdx
similarity index 100%
rename from api-reference/sandboxes/upload.mdx
rename to api-reference/sandboxes/upload-files.mdx
diff --git a/docs.json b/docs.json
index 997ebc58..458ada9e 100644
--- a/docs.json
+++ b/docs.json
@@ -267,8 +267,9 @@
               "api-reference/sandboxes/snapshot",
               "api-reference/sandboxes/delete",
               "api-reference/sandboxes/setup",
-              "api-reference/sandboxes/file",
-              "api-reference/sandboxes/upload"
+              "api-reference/sandboxes/get-file",
+              "api-reference/sandboxes/stage-file",
+              "api-reference/sandboxes/upload-files"
             ]
           },
           {