Retained results

Read an independent retained byte range

One bounded raw byte range from immutable control-plane storage, with fresh authorization before and after the read. No guest or execution-handle calls. Independent retries never consume a cursor or change expiry. At or beyond retained EOF the body is empty, next offset is unchanged and EOF is true. Unknown or duplicate query parameters and unsafe offset+limit are refused. Range headers are not supported. Response headers: X-Result-Offset (requested byte offset), X-Result-Next-Offset (offset plus returned bytes), X-Result-EOF (true or false for the retained stream), exact Content-Length, attachment Content-Disposition with a generated filename, nosniff and no-store.

Requires the member role or higher.

get/computers/{id}/results/{resultId}/output

Request

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

Path parameters

idstring required

The computer id.

resultIdstring required

A result_id from a retained exec (res_ followed by 32 lowercase hex characters).

Query parameters

stream'stdout' | 'stderr' | 'diagnostic' required

The retained stream to read. Synchronous output has no diagnostic; requesting it returns result_stream_unavailable 409.

offsetinteger required

Explicit nonnegative decimal byte offset; offset plus limit must be a safe integer.

limitinteger

Maximum response bytes.

Response

Raw bytes, never base64. EOF describes the retained prefix only.

Changes

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