diff --git a/docs/api-reference/arc-api.yaml b/docs/api-reference/arc-api.yaml
index 5b1bbc5a7..120063918 100644
--- a/docs/api-reference/arc-api.yaml
+++ b/docs/api-reference/arc-api.yaml
@@ -140,7 +140,7 @@ paths:
   /runs/{id}/checkpoint:
     get:
       operationId: retrieveRunCheckpoint
-      tags: [Runs]
+      tags: [Run Internals]
       summary: Retrieve Run Checkpoint
       parameters:
         - $ref: "#/components/parameters/RunId"
@@ -404,6 +404,29 @@ paths:
         "404":
           description: Run not found
 
+  /runs/{id}/preview:
+    post:
+      operationId: generatePreviewUrl
+      tags: [Runs]
+      summary: Generate a sandbox preview URL
+      parameters:
+        - $ref: "#/components/parameters/RunId"
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: "#/components/schemas/PreviewUrlRequest"
+      responses:
+        "200":
+          description: Preview URL generated
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/PreviewUrlResponse"
+        "404":
+          description: Run not found
+
   # ── Workflows ─────────────────────────────────────────────────────────
 
   /workflows:
@@ -1258,6 +1281,25 @@ components:
         guidance:
           type: string
 
+    PreviewUrlRequest:
+      type: object
+      required:
+        - port
+        - expires_in_secs
+      properties:
+        port:
+          type: integer
+        expires_in_secs:
+          type: integer
+
+    PreviewUrlResponse:
+      type: object
+      required:
+        - url
+      properties:
+        url:
+          type: string
+
     # ── Workflow Schemas ─────────────────────────────────────────────────
 
     WorkflowListItem: