---
title: "Create Volume"
method: POST
path: "/apps/{app_name}/volumes"
tags: ["Volumes"]
---

# Create Volume

`POST /apps/{app_name}/volumes`

Create a volume for a specific app using the details provided in the request body.

## Path parameters

- `app_name` string, required

## Request body

- CreateVolumeRequest
  - `auto_backup_enabled` boolean — enable scheduled automatic snapshots. Defaults to `true`
  - `compute` FlyMachineGuest
    - `cpu_kind` string
    - `cpus` integer
    - `gpu_kind` string
    - `gpus` integer
    - `host_dedication_id` string
    - `kernel_args` string[]
    - `max_memory_mb` integer
    - `memory_mb` integer
    - `persist_rootfs` 'never' | 'always' | 'restart' — Deprecated: use MachineConfig.Rootfs instead
  - `compute_image` string
  - `encrypted` boolean
  - `fstype` string
  - `name` string
  - `region` string
  - `require_unique_zone` boolean
  - `size_gb` integer
  - `snapshot_id` string — restore from snapshot
  - `snapshot_retention` integer
  - `source_volume_id` string — fork from remote volume
  - `unique_zone_app_wide` boolean

## Response `200`

OK

- Volume
  - `attached_alloc_id` string
  - `attached_machine_id` string
  - `auto_backup_enabled` boolean
  - `block_size` integer
  - `blocks` integer
  - `blocks_avail` integer
  - `blocks_free` integer
  - `bytes_total` integer
  - `bytes_used` integer
  - `created_at` string
  - `encrypted` boolean
  - `fstype` string
  - `host_status` 'ok' | 'unknown' | 'unreachable'
  - `id` string
  - `name` string
  - `region` string
  - `size_gb` integer
  - `snapshot_retention` integer
  - `state` string
  - `type` 'local' | 'cache'
  - `zone` string

---

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