CLI reference / sandbox / file-url

stado sandbox file-url

Invocation

stado sandbox file-url [OPTIONS] --method <METHOD> <ID> <PATH>

Purpose

Print a short-lived URL the sandbox serves for one file: a GET of it downloads the file, a PUT of the bytes writes it, with no size limit and no key. The URL is a secret until it expires

Required inputs and options

Input or optionContract
<ID>The sandbox id Boat answered at create, fork or list
<PATH>The file's path, absolute or under the sandbox's work directory
--method <METHOD>Whether the URL downloads the file or uploads it [possible values: download, upload]
--ttl-seconds <TTL_SECONDS>How many seconds the URL stays valid; without it Boat's own lifetime

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.