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

# POST /osd-snapshots

`POST /osd-snapshots`

Take a snapshot of volume in SnapCreateRequest

## Query parameters

- `id` string, 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
  - `volume_create_response` VolumeCreateResponse
    - `id` string — ID of the newly created volume
    - `volume_response` VolumeResponse
      - `error` string

## Other responses

- `default` — unexpected error

## Changes

- **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/d79082f863d1/schema)