Retained results

Publish a nominated immutable artifact

Explicitly capture one nominated guest file into immutable private retained storage. Accepts at most 32768 bytes of application/json and a 60000 millisecond control-plane deadline. The computer must already be running: one source file GET uses no_wake=1 and may touch guest activity. No automatic capture, shell, directory scan, Range assembly or retry on another host. Exact transferred bytes must match expected_size and expected_sha256; no prefix success. A live path may change or follow symlinks; digest matching is not an atomic snapshot or proof of who created a file. Optional execution_id must currently resolve on the same computer and recorded scope; its caller_selected association does not prove creation. Retrying creates another version; no listing or idempotency key. created_at is final publication time; expiry starts at reservation and never renews on reads. All routes require member and refuse suspended accounts. Artifacts and retained output share one store quota: at most 128 MiB and 256 objects per computer, 512 MiB and 2000 objects per account, and 2 captures in progress per account. An artifact is charged at expected_size from reservation; a retained-output capture at twice max_bytes_per_stream, plus the diagnostic for background output. Deleted objects stay charged until physical cleanup. Past any limit, or when the platform store is full, the answer is 429 result_capacity with Retry-After: 60. No query parameters or caller metadata. A verified execution association may add a passive result link to its existing activity. Responses are no-store with a relative Location. Daemon guest transfer can outlive control-plane cancellation.

Requires the member role or higher.

post/computers/{id}/artifacts

Request

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

Path parameters

idstring required

The computer id.

Request body

pathstring required

Exact OS-absolute guest path, at most 4096 UTF-8 bytes, valid Unicode with no controls/DEL. Spaces and Linux backslashes are preserved.

expected_sizeinteger required
expected_sha256string required
execution_idstring
max_bytesinteger

Expected size must not exceed this cap. Larger files require explicit opt-in above the default.

retention_secondsinteger

Response

Finite immutable artifact metadata, without source path, account attribution, command or raw content.

artifact_idstring required
kind'artifact' required
state'ready' required
computer_idstring required
workspace_idstring nullable required
created_atstring date-time required
expires_atstring date-time required
sizeinteger required
sha256string required

Changes

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