---
title: "POST /osd-snapshots"
method: POST
path: "/osd-snapshots"
tags: ["snapshot"]
---

# POST /osd-snapshots

`POST /osd-snapshots`

Take a snapshot of volume in SnapCreateRequest

## Query parameters

- `id` integer, required

## Request body

- SnapCreateRequest
  - `id` string — volume id
  - `locator` VolumeLocator — VolumeLocator is a structure that is attached to a volume and is used to carry opaque metadata.
    - `name` string — User friendly identifier
    - `volume_labels` object — A set of name-value pairs that acts as search filters
  - `readonly` boolean

## Response `200`

an array of volumes

- SnapCreateResponse — SnapCreateResponse
  - `volume_create_response` VolumeCreateResponse — VolumeCreateResponse
    - `id` string, required — ID of the newly created volume in: body
    - `volume_response` VolumeResponse, required
      - `error` string, required — Error message in: body

## Other responses

- `default` — unexpected error

## Changes

- **2018-02-22** `ed1f944f48d5` — 1 info
  - api tag `create` removed
- **2017-12-05** `d79082f863d1` — 1 info
  - api tag `create` added

[Change history](https://skmtc.dev/libopenstorage/apis/osd-api/changes/osd-snapshots/post.md)

---

[API](https://skmtc.dev/libopenstorage/apis/osd-api.md) · [All operations](https://skmtc.dev/libopenstorage/apis/osd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/libopenstorage/osd-api/revisions/ed1f944f48d5/schema)