---
search:
  tags:
    - snapshots
    - POST
seo:
  description: >-
    The machine's current disk is captured first, so the state being… Reference
    for the POST /v1/machines/{machine_id}/restore endpoint in the Computer API
    API.
sidebar:
  badge: POST
  label: restore a machine from a snapshot
title: restore a machine from a snapshot
type: openapi-operation
---
The machine's current disk is captured first, so the state being replaced stays recoverable, and the machine is then restarted onto the snapshot. A running machine comes back running; a stopped machine stays stopped and boots into the restored disk on its next start. Open sessions are disconnected.

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