Write a file
Writes the raw request body to path under the sandbox root, creating its directories and replacing any existing file (it never appends). A file may be up to 2 GiB, refused on the declared content-length before any upload. The body goes on to the Mac in 4 MiB parts as it arrives, and the answer comes once all of it is written there, so a large write takes as long as its upload; the whole body must arrive within 40 minutes. A write over 4 MiB keeps its parts in a hidden .offstage-upload-… folder at the sandbox root and joins them into the file once the last part is in. A team may have 24 MiB of file writes held at once, and a write holds at most 8 MiB of it however large it is; a write past that is 429 uploads-busy.
Authorizations
Query Parameters
Relative to the sandbox root (/Users/<slot>/offstage-sandbox/<sandbox id>): letters, digits, ., _, - and /, no .. segment, no leading / or ~, at most 1024 characters. . segments and repeated slashes are normalized away.
1 - 1024^(?!/)(?!(.*/)?\.\.(/|$))[A-Za-z0-9._/-]+$Body
The file's bytes, sent as-is. Any content-type is accepted; an empty body writes an empty file.
The body is of type file.