---
title: "Create a vm recovery point."
method: POST
path: "/vms/{uuid}/snapshot"
tags: ["vms"]
---

# Create a vm recovery point.

`POST /vms/{uuid}/snapshot`

Submits a request to create a task handling the snapshot operation on the vm, returns a task reference. This creates a point in time recovery point.

## Path parameters

- `uuid` string, UUID, required

## Request body

- VmSnapshotInput — Input object for the snapshot API. User can provide optional UUID of the vm_recovery_point that will be created as a result of this operation.
  - `expiration_time` string, date-time — The time when this recovery point expires and will be garbage collected. This is in internet date/time format (RFC 3339). If not set, then the recovery point never expires.
  - `vm_recovery_point_uuid` string, UUID
  - `recovery_point_type` string — Crash consistent or Application Consistent recovery point

## Response `202`

Request Accepted

- ProceduralResponse — Response for invoking a procedural call. Contains a task UUID.
  - `task_uuid` string, UUID, required

## Other responses

- `404` — Invalid UUID provided
- `default` — Internal Error

---

[API](https://skmtc.net/nutanix/apis/nutanix-intentful-api.md) · [All operations](https://skmtc.net/nutanix/apis/nutanix-intentful-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nutanix/nutanix-intentful-api/revisions/40395083ab31/schema)