---
title: "POST /api/block/image/{image_spec}/snap/{snapshot_name}/clone"
method: POST
path: "/api/block/image/{image_spec}/snap/{snapshot_name}/clone"
tags: ["RbdSnapshot"]
---

# POST /api/block/image/{image_spec}/snap/{snapshot_name}/clone

`POST /api/block/image/{image_spec}/snap/{snapshot_name}/clone`

Clones a snapshot to an image

## Path parameters

- `image_spec` string, required
- `snapshot_name` string, required

## Request body

- object
  - `child_image_name` string, required
  - `child_namespace` string
  - `child_pool_name` string, required
  - `clone_by_snap_id` boolean
  - `configuration` string
  - `data_pool` string
  - `features` string
  - `metadata` string
  - `obj_size` integer
  - `stripe_count` integer
  - `stripe_unit` string

## Response `201`

Resource created.

- object

## Other responses

- `202` — Operation is still executing. Please check the task queue.
- `400` — Operation exception. Please check the response body for details.
- `401` — Unauthenticated access. Please login first.
- `403` — Unauthorized access. Please check your permissions.
- `500` — Unexpected error. Please check the response body for the stack trace.

## Changes

- **2026-06-30** `ecd4bae8a2f1` — 1 info
  - added the new optional request property `clone_by_snap_id`

[Change history](https://skmtc.dev/ceph/apis/ceph-rest-api/changes/api/block/image/:image_spec/snap/:snapshot_name/clone/post.md)

---

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