---
title: "Recover from a snapshot"
method: PUT
path: "/collections/{collection_name}/snapshots/recover"
tags: ["Snapshots"]
---

# Recover from a snapshot

`PUT /collections/{collection_name}/snapshots/recover`

Recover local collection data from a snapshot. This will overwrite any data, stored on this node, for the collection. If collection does not exist - it will be created.

## Path parameters

- `collection_name` string, required

## Query parameters

- `wait` boolean

## Request body

- SnapshotRecover
  - `location` string, uri, required — Examples: - URL `http://localhost:8080/collections/my_collection/snapshots/my_snapshot` - Local path `file:///qdrant/snapshots/test_collection-2022-08-04-10-49-10.snapshot`
  - `priority` union — Defines which data should be used as a source of truth if there are other replicas in the cluster. If set to `Snapshot`, the snapshot will be used as a source of truth, and the current state will be overwritten. If set to `Replica`, the current state will be used as a source of truth, and after recovery if will be synchronized with the snapshot.
    - 'no_sync' | 'snapshot' | 'replica' — Defines source of truth for snapshot recovery: `NoSync` means - restore snapshot without *any* additional synchronization. `Snapshot` means - prefer snapshot data over the current state. `Replica` means - prefer existing data over the snapshot.
    - unknown
  - `checksum` string, nullable — Optional SHA256 checksum to verify snapshot integrity before recovery.
  - `api_key` string, nullable — Optional API key used when fetching the snapshot from a remote URL.

## Response `200`

successful operation

- object
  - `time` number, float — Time spent to process this request
  - `status` string
  - `result` boolean

## Other responses

- `202` — operation is accepted
- `default` — error
- `4XX` — error

---

[API](https://skmtc.net/qdrant/apis/qdrant-api.md) · [All operations](https://skmtc.net/qdrant/apis/qdrant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qdrant/qdrant-api/revisions/d08b1f613f29/schema)