Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Hiloop API key sent as an HTTP Bearer token.

Headers

idempotency-key
string

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.

Required string length: 1 - 255

Path Parameters

id
string
required

The running sandbox in which to execute the command.

Body

application/json
cmd
string[]
required

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.

Required array length: 1 - 256 elements
Maximum string length: 4096
timeout_seconds
integer<uint32>

Execution timeout in whole seconds, from 1 through 3600. Omit it to use the server default; sub-second budgets are outside this version.

Required range: 1 <= x <= 3600
secret_environment
object[]

Secret references released atomically into the child environment. No value crosses this public API. Omit for ordinary execution.

Response

OK

Buffered output and the real exit code from a completed command; truncated reports output loss independently.

stdout
string
required

Buffered standard output. It may contain partial output on a timeout or an indeterminate outcome.

stderr
string
required

Buffered standard error. It may contain partial output on a timeout or an indeterminate outcome.

exit
integer<int32>
required

The process exit code for a completed command, including zero.

truncated
boolean
required

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.