Post v1sandboxes exec
Execute one command in the sandbox’s workload container and return buffered output. An optional Idempotency-Key provides replay safety: a repeated request carrying the same key replays the recorded outcome instead of executing the command a second time, which is what makes a retry safe after a response is lost in transit. Timeout and indeterminate are process outcomes, not errors; truncation is an orthogonal output property and never replaces a real process exit code.
Authorizations
Hiloop API key sent as an HTTP Bearer token.
Headers
Optional idempotency key for this mutation. The server records the result from execution start. For at least 72 hours, reuse by the same organization and route replays the original status and body. A matching request still in flight or reuse for different input returns 409 idempotency_conflict. Keys are scoped by organization and route and contain 1-255 characters.
1 - 255Path Parameters
The running sandbox in which to execute the command.
Body
Command and arguments. The first entry is a non-empty executable; at most 256 entries are accepted and each entry is at most 4096 characters.
1 - 256 elements4096Execution timeout in whole seconds, from 1 through 3600. Omit it to use the server default; sub-second budgets are outside this version.
1 <= x <= 3600Secret references released atomically into the child environment. No value crosses this public API. Omit for ordinary execution.
Response
OK
- Option 1
- Option 2
- Option 3
Buffered output and the real exit code from a completed command; truncated reports output loss independently.
Buffered standard output. It may contain partial output on a timeout or an indeterminate outcome.
Buffered standard error. It may contain partial output on a timeout or an indeterminate outcome.
The process exit code for a completed command, including zero.
Whether stdout or stderr was truncated at the server-configured combined output cap. The default cap is no more than 1 MiB. Truncation does not replace the real process outcome.