---
search:
  tags:
    - snapshots
    - POST
seo:
  description: >-
    The machine must be running: a disk is captured from a live instance. The
    snapshot is… Reference for the POST /v1/snapshots endpoint in the Computer
    API API.
sidebar:
  badge: POST
  label: capture a machine's disk
title: capture a machine's disk
type: openapi-operation
---
The machine must be running: a disk is captured from a live instance. The snapshot is returned in `pending` and becomes `ready` when the capture finishes. RAM and live process state are never captured.

<Operation source="api" id="snapshots-create" />