Create a resumable upload session
Creates a Firecracker-backed upload session with fixed part_size, max_concurrency, and expires_at values chosen by the runtime. The returned session is the source of truth for resumable file and directory archive uploads.
Authorizations
API key passed as Bearer token
Headers
Reuse the same key to safely retry the same create, reusable snapshot create, fork, upload create/complete, or agent deployment create operation without duplicating work.
Path Parameters
Machine ID (e.g. mch_a1b2c3d4)
Body
file, directory_tar restartable_file, spooled_stream, directory_archive Requested upload destination path. Absolute paths may target valid machine locations such as /workspace, /tmp, /data, or /context where present. Relative paths resolve from the machine cwd when set, otherwise from the selected user's home when user is provided, otherwise from /workspace. Reserved runtime paths under /workspace/.nullspace are rejected.
merge, replace, error sha256 Optional machine user for relative-path resolution and ownership.
tar Free-form client-supplied metadata for the upload session; stored verbatim, deliberately open.
Response
Upload session created