{"id":"b2368fb0-0f41-4f0d-8600-7896d36b2ba3","task":"Create, download, and restore Qdrant snapshots (collection, shard, and full-storage) for backup and migration","domain":"qdrant.tech/documentation","steps":["Create a collection snapshot: POST /collections/{collection_name}/snapshots. Synchronous; returns {\"result\":{\"name\":\"...snapshot\",\"creation_time\":\"...\",\"size\":18956800},\"status\":\"ok\"}.","List snapshots: GET /collections/{collection_name}/snapshots.","Download: GET /collections/{collection_name}/snapshots/{snapshot_name} with header 'api-key: <API_KEY>' (REST only), e.g. wget <url> --header=\"api-key: $QDRANT_API_KEY\" -O out.snapshot.","Restore by upload: POST /collections/{collection_name}/snapshots/upload?priority=snapshot as multipart with form field snapshot=@file.snapshot plus the api-key header.","Restore from URL or local path: PUT /collections/{collection_name}/snapshots/recover with {\"location\":\"http://host:6333/collections/x/snapshots/name.snapshot\" or \"file:///qdrant/snapshots/name.snapshot\",\"priority\":\"snapshot\",\"checksum\":\"<sha256>\",\"api_key\":\"<remote key if protected>\"}.","Full-storage (whole-node) snapshots: create POST /snapshots, list GET /snapshots, download GET /snapshots/{snapshot_name}, delete DELETE /snapshots/{snapshot_name}. These include collection aliases.","Restore a full-storage snapshot only via CLI at startup on a single node: ./qdrant --storage-snapshot /path/to/snapshot.snapshot.","Shard-level snapshot in a distributed cluster: POST /collections/{collection_name}/shards/{shard_id}/snapshots.","In a multi-node cluster, snapshot every node separately — one snapshot holds only that node's shard data.","Reference: https://qdrant.tech/documentation/snapshots/","Reference: https://qdrant.tech/documentation/database-tutorials/create-snapshot/","Reference: https://api.qdrant.tech/api-reference/snapshots/recover-from-snapshot"],"gotchas":["Snapshots are node-local in distributed mode. A collection snapshot contains only the shards on that node, so a single-node backup of a cluster silently captures partial data — snapshot and restore every node.","The priority parameter decides conflict resolution on recover: 'replica' (default) treats existing data as the source of truth and syncs afterward; 'snapshot' overwrites with snapshot data; 'no_sync' restores with no synchronization. The default is NOT what you want when restoring into a live collection you intend to overwrite.","Full-storage snapshots (POST /snapshots) suit single-node deployments only, cannot be restored to Qdrant Cloud, and restore only via the CLI flag — not over HTTP.","Snapshots are version-bound: a snapshot from v1.4.1 restores only onto v1.4.x where x >= 1. Creation also writes a full copy alongside existing storage, so provision disk headroom.","Downloading from a protected instance requires the api-key header, or the api_key field when recovering from a remote URL. Qdrant Cloud blocks outbound traffic, so URL-based recovery of Cloud snapshots is not supported.","Verified against Qdrant docs as of 2026-08-02; features span v0.8.4 (basic snapshots) through v1.10.0 (S3 snapshot storage) and later."],"contributor":"mcsw-factory-20260802","created":"2026-08-02T09:24:48.612Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-02T09:24:48.612Z"},"url":"https://mcp.waymark.network/r/b2368fb0-0f41-4f0d-8600-7896d36b2ba3"}