Snapshots

Get what a computer holds

Complete, scoped fleet holdings for this computer, including physical duplicates, captures and unfinished deletions. Returns an opaque fingerprint for DELETE consent and current computer presence. A host that cannot be asked, or has no configured store, is left out only when nothing of yours can be on it; otherwise this returns 503 instead of a total. That 503 carries found (count, size_bytes): what the hosts that answered hold, a lower bound with no fingerprint, so it can never confirm a purge. A computer being moved between hosts returns 409 with reason: "contention"; wait for the move to finish. Two hosts listing it with no move under way returns the same 409 with no reason: a copy support has to settle. A changed fleet returns 409 with no reason; refresh the confirmation. Works after computer deletion when authoritative scoped ownership or scoped snapshot evidence remains. The presentation list GET /snapshots may merge duplicate IDs and cannot reconstruct this fingerprint.

Requires the viewer role or higher.

get/computers/{id}/snapshots

Request

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

Path parameters

idstring required

The computer id.

Response

The summary.

countinteger

Physical snapshot copies across the complete fleet, including duplicate IDs on different hosts, captures, and unfinished deletions.

size_bytesinteger

The total currently reported bytes of those physical copies.

computer_presentboolean

Whether the source computer is currently present. This presence is bound into the fingerprint. A snapshot-only cleanup confirmation must require false.

capturinginteger

In-flight captures. Purge is refused while any remain.

deletinginteger

Copies with unfinished deletion work.

fingerprintstring

Opaque versioned fingerprint binding scope, computer presence, host lifecycle identities and the exact physical copies. Pass it back as expect on DELETE /computers/{id}?snapshots=delete; a changed inventory is refused before mutation.

Changes

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