Control

Read execution output independently

Explicit guest-file reads with caller-owned byte offsets. No shared cursor or diagnostic is consumed. Retry the same offsets after a lost response; reads never replay a command or automatically resume the computer. A stopped or suspended computer returns 409. A missing log returns 409 with code output_unavailable, not empty output. Unknown, expired, replaced or lost handles return 404 with code execution_unavailable; a computer outside the caller’s scope returns 404 computer not found with no code. Empty success means the existing files had no bytes at the supplied positions. This route reads volatile, mutable guest paths: deletion, truncation, replacement or tampering can change bytes between retries. It is not suitable for passive Activities/history; explicitly capture retained-output for immutable later reads. Each query key may appear once. Offsets and limit must be nonnegative decimal integers; each offset plus limit must be at most 9007199254740991. Responses are no-store.

Requires the member role or higher.

get/computers/{id}/executions/{executionId}/output

Request

  • Base URL: https://app.mandala.computer/api/v1
  • URL: https://app.mandala.computer/api/v1/computers/{id}/executions/{executionId}/output
  • Auth: HTTP bearer

Path parameters

idstring required

The computer id.

executionIdstring required

The opaque execution_id from a backgrounded exec (exec_ followed by 32 lowercase hex characters).

Query parameters

stdout_offsetinteger required

Explicit stdout byte offset. Start at 0; offset + limit must remain a safe JavaScript integer.

stderr_offsetinteger required

Explicit independent stderr byte offset. Start at 0.

limitinteger

Maximum decoded bytes per stream, not including the separate 64 KiB diagnostic.

Response

Bounded raw bytes and next independent offsets.

execution_idstring required

The requested stable execution ID.

stdout_b64string required

Raw stdout bytes, base64; at most limit decoded bytes.

stderr_b64string required

Raw stderr bytes, base64; at most limit decoded bytes.

stdout_offsetinteger required

Next stdout byte offset: supplied offset plus decoded bytes returned.

stderr_offsetinteger required

Next stderr byte offset, independent of stdout and all other readers.

stdout_moreboolean required

The read reached its limit without observing EOF. Another read may still be empty.

stderr_moreboolean required

The same for stderr. False is a current EOF observation, not a promise of no future output.

diagnostic_b64string required

Separate daemon-captured wrapper diagnostic, base64, at most 65536 decoded bytes. Repeated in full on every read; not part of either guest-file offset. Legacy reads cannot consume it.

diagnostic_truncatedboolean required

The wrapper diagnostic exceeded 65536 bytes or guest-agent capture was truncated; the diagnostic is incomplete.

Changes

No recorded changes to this operation across all 1 revision of this API.