Retained results

Read an independent retained byte range (headers only)

The GET of this path with no response body. It is authorized exactly as the GET is and answers its statuses and headers, never a body: an error’s correlation is in X-Request-ID alone. Range is ignored. This one checks metadata instead of reading the content: it never resumes a guest, consumes output or opens a stream, so a header or failure that only reading the content could produce may be missing.

Requires the member role or higher.

head/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.