---
title: "Extend Volume"
method: PUT
path: "/v1/apps/{app_name}/volumes/{volume_id}/extend"
tags: ["Volumes"]
---

# Extend Volume

`PUT /v1/apps/{app_name}/volumes/{volume_id}/extend`

## Request

- Base URL: `https://api.machines.dev`
- URL: `https://api.machines.dev/v1/apps/{app_name}/volumes/{volume_id}/extend`
- Auth: HTTP bearer

Extend a volume's size within an app using the details provided in the request body.

## Path parameters

- `app_name` string, required
- `volume_id` string, required

## Request body

- ExtendVolumeRequest
  - `size_gb` integer

## Response `200`

OK

- ExtendVolumeResponse
  - `needs_restart` boolean
  - `volume` 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_features` string[]
    - `host_status` 'ok' | 'unknown' | 'unreachable'
    - `id` string
    - `name` string
    - `region` string
    - `required_host_features` string[]
    - `size_gb` integer
    - `snapshot_retention` integer
    - `state` string
    - `type` 'local' | 'cache'
    - `zone` string

## Changes

- **2026-09-18** `b1988c8e4bd9`: 2 info
  - added the optional property `volume/host_features` to the response with the `200` status
  - added the optional property `volume/required_host_features` to the response with the `200` status
- **2026-08-12** `f54480c4ce7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/machines/apis/machines-api/changes/v1/apps/:app_name/volumes/:volume_id/extend/put.md)

---

[API](https://skmtc.dev/machines/apis/machines-api.md) - [All operations](https://skmtc.dev/machines/apis/machines-api/llms.txt) - [OpenAPI document](https://skmtc.dev/machines/apis/machines-api/revisions/0e800519539e?raw)