---
title: "Create VM backup (top-level)"
method: POST
path: "/virtual_machine_backups"
tags: ["Virtual machine backups"]
---

# Create VM backup (top-level)

`POST /virtual_machine_backups`

Triggers a backup of the Virtual Machine referenced in the body.

## Request body

- VirtualMachineBackupPayload
  - `data` object
    - `type` 'virtual_machine_backups'
    - `attributes` object
      - `virtual_machine` string, required — Virtual machine id to back up. Required on the top-level `POST /virtual_machine_backups`; taken from the path when nested under a VM.

## Response `201`

Created

## Other responses

- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.net/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude/latitude-sh-api/versions/7302d79e39bb/schema)