---
title: "Create shard snapshot"
method: POST
path: "/collections/{collection_name}/shards/{shard_id}/snapshots"
tags: ["Snapshots"]
---

# Create shard snapshot

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

## Request

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

Create new snapshot of a shard for a collection

## Path parameters

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

## Query parameters

- `wait` boolean

## Response `200`

successful operation

- object
  - `time` number, float: Time spent to process this request
  - `status` string
  - `result` SnapshotDescription
    - `name` string, required
    - `creation_time` string, partial-date-time, nullable
    - `size` integer, required
    - `checksum` string, nullable

## 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/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)