Verify Snapshot Restore-Readiness
Read-only pre-flight check that a snapshot can actually be restored. Restore is lenient and silently skips missing artifacts, so this surfaces what a restore would drop (missing collection dumps, unreachable vectors, absent copied objects) BEFORE you depend on it in a recovery. Pass deep=true to also decompress each collection dump and detect truncation.
Authorizations
Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.
Path Parameters
Namespace name or ID
Snapshot ID to verify (e.g. snap_xxxxxxxxxxxx)
Query Parameters
Also decompress each collection dump to detect truncated artifacts
Response
Successful Response
Result of a read-only pre-flight check that a snapshot can be restored.
Restore itself is LENIENT — a missing collection dump is caught and logged as a warning, so restore reports success while SILENTLY dropping data. This check surfaces exactly what restore would skip BEFORE you depend on it in a recovery, by re-validating the snapshot's object-store artifacts against the manifest it claims to hold (no materialization).
True iff there are no error-severity issues (a clean restore is possible)
Count of expected (non-empty) collection dumps found present
Where vectors would restore from: 'self', the shard-representative prefix (coalesced), 'none', or null if unresolved
Deep-verify per-point vector NON-emptiness verdict. 'measured_ok': captured points carry non-empty vectors. 'measured_degraded': a significant fraction carry EMPTY vectors — the Raw-absence signature (a raw-less point scrolls back with vectors=[] yet counts as captured), so a restore would be searchable-degraded even though the point-count guard passed. 'could_not_measure': not deep-verified, metadata-only, or unreadable. Three-valued by design — could_not_measure must never render as ok (a boolean would collapse incapacity into the healthy value).

