From db9227db7082ca4a2c9408dcf3701416a692e1b8 Mon Sep 17 00:00:00 2001 From: Luke Jolly Date: Thu, 19 Nov 2026 02:38:21 -0700 Subject: [PATCH 1/2] docs(sandboxes): document file read refusal codes --- content/platform/guides/sandboxes.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/content/platform/guides/sandboxes.md b/content/platform/guides/sandboxes.md index 330dda9..3a74bf2 100644 --- a/content/platform/guides/sandboxes.md +++ b/content/platform/guides/sandboxes.md @@ -584,6 +584,15 @@ run as the session user, so a write into a directory that user cannot write retu `409` with code `sandbox_path_conflict`. Files survive suspend/resume and are removed with the session. +A read of a path with no file returns `404` with code `sandbox_file_not_found`. +A directory, symbolic link, or special file at the path returns `400` with code +`sandbox_file_unreadable`, as does, in a cloud session, a file the session user +does not own or that has more than one hard link. A file larger than 8 MiB +returns `413` with code `sandbox_file_too_large`. A session from an image built +before these codes, such as a custom template not redeployed since, returns +`503` instead; start a new session from a current preset, or redeploy the +template. + ### Upload a directory as a tar archive Create a file archive to write a whole tree in one request. Send From 2adf0ce6ebdfd938fd1d47eca204aab1fa838a6f Mon Sep 17 00:00:00 2001 From: Luke Jolly Date: Thu, 19 Nov 2026 02:52:08 -0700 Subject: [PATCH 2/2] docs(sandboxes): name every unreadable file read case --- content/platform/guides/sandboxes.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/content/platform/guides/sandboxes.md b/content/platform/guides/sandboxes.md index 3a74bf2..c921482 100644 --- a/content/platform/guides/sandboxes.md +++ b/content/platform/guides/sandboxes.md @@ -585,9 +585,11 @@ run as the session user, so a write into a directory that user cannot write retu the session. A read of a path with no file returns `404` with code `sandbox_file_not_found`. -A directory, symbolic link, or special file at the path returns `400` with code -`sandbox_file_unreadable`, as does, in a cloud session, a file the session user -does not own or that has more than one hard link. A file larger than 8 MiB +A directory, symbolic link, socket, or other special file at the path returns +`400` with code `sandbox_file_unreadable`, as does a file the session user can't +read and, in a cloud session, a file another user owns or one with more than one +hard link. Copy such a file to a new one with an exec command, then read the +copy. A file larger than 8 MiB returns `413` with code `sandbox_file_too_large`. A session from an image built before these codes, such as a custom template not redeployed since, returns `503` instead; start a new session from a current preset, or redeploy the