u

docs/api/routes/vfs/_*path.md

@@ -8,14 +8,12 @@ Returns a file the model produced in the `javascript_execute` sandbox
 (virtual filesystem), for the authenticated user's selected company.
 
 Embed the returned URL in chat markdown to display a generated image:
-`![title](/api/vfs/example.png)`.     *
-Images are ALWAYS returned as a preview: scaled to fit inside a 250x250 box with the
-aspect ratio preserved (never stretched), and anything smaller than 100 px on its larger
-edge is upscaled to 100 px. The preview carries a translucent strip along the bottom
-edge listing the ORIGINAL width, height, file size, MIME type and filename.     *
-Only image MIME types the sandbox produces are rendered inline; every other file
-type is sent with `Content-Disposition: attachment` so it downloads rather than
-being interpreted as a document in the app's origin.
+`![title](/api/vfs/example.png)`.
+
+Images are returned as a 250x250 aspect-preserving preview unless requested with
+`download=1` or `raw=1`.
+Browser-compatible files (HTML, CSS, JS, JSON, PDF, text, images, media) are served
+inline so they open directly in the browser; other files are sent as downloads.
 
 
 ## Path parameters
@@ -28,10 +26,9 @@ being interpreted as a document in the app's origin.
 
 | Param | Required | Type | Description |
 |-------|----------|------|-------------|
-| `download` | no | boolean | Return the original, unmodified file instead of the standard preview.
-Without this parameter images are always served as a 250x250 aspect-preserving
-preview with a metadata strip. Ignored for non-image files, which are always
-served as-is.
+| `download` | no | boolean | Force file download with Content-Disposition: attachment.
+ |
+| `raw` | no | boolean | Return original unmodified image inline without generating a preview thumbnail.
  |
 
 ## Response `200`