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

# Recover from a snapshot

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

## Request

- Base URL: `http://localhost:6333`
- URL: `http://localhost:6333/collections/{collection_name}/shards/{shard_id}/snapshots/recover`
- Auth: one of:
  - API key in header `api-key`
  - HTTP bearer
  - none
- TypeScript: <https://skmtc.dev/qdrant/apis/qdrant-api/docs/collections/:collection_name/shards/:shard_id/snapshots/recover/put.ts> (a function with typed inputs; its response is checked against the schema)

Recover shard of a local collection data from a snapshot. This will overwrite any data, stored in this shard, for the collection.

## Path parameters

- `collection_name` string, required
- `shard_id` integer, required

## Query parameters

- `wait` boolean

## Request body

- ShardSnapshotRecover
  - `location` union, required
    - string, uri
    - string
  - `priority` union
    - '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

## Changes

- **2025-01-17** `a7900f38a79d`: 3 info
  - api tag `Snapshots` added
  - api tag `collections` removed
  - api tag `snapshots` removed

[Operation history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/shards/:shard_id/snapshots/recover/put.md)

---

[API](https://skmtc.dev/qdrant/apis/qdrant-api.md) - [All operations](https://skmtc.dev/qdrant/apis/qdrant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qdrant/apis/qdrant-api/revisions/c93be9a86fe5?raw)