---
title: "Recover shard from an uploaded snapshot"
method: POST
path: "/collections/{collection_name}/shards/{shard_id}/snapshots/upload"
tags: ["Snapshots"]
---

# Recover shard from an uploaded snapshot

`POST /collections/{collection_name}/shards/{shard_id}/snapshots/upload`

## Request

- Base URL: `http://localhost:6333`
- URL: `http://localhost:6333/collections/{collection_name}/shards/{shard_id}/snapshots/upload`
- 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/upload/post.ts> (a function with typed inputs; its response is checked against the schema)

Recover shard of a local collection from an uploaded snapshot. This will overwrite any data, stored on this node, for the collection shard.

## Path parameters

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

## Query parameters

- `wait` boolean
- `priority` '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.
- `checksum` string

## Request body `multipart/form-data`

- object
  - `snapshot` string, binary

## 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/upload/post.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)