---
title: "Resize Volume"
method: PATCH
path: "/api/v1/volumes/{id}"
tags: ["Volumes"]
---

# Resize Volume

`PATCH /api/v1/volumes/{id}`

Increase the size of a block storage volume.
Volume size can only be increased, never decreased.

## Billing

For subscription volumes, the storage cost difference is calculated
pro-rata and deducted from credits, then account balance.
Returns `402` if insufficient balance.

## Path parameters

- `id` integer, required

## Headers

- `X-Project-ID` string, uuid, required

## Request body

- ResizeVolumeRequest
  - `new_size` integer, required — New volume size in GB. Must be larger than current size.

## Response `200`

Volume resized

- ResizeResponse
  - `success` boolean
  - `message` string
  - `id` string — Resource ID.
  - `billing` ResizeBillingDetails — Present only for subscription-based resources.
    - `type` 'upgrade' | 'downgrade' | 'none'
    - `pro_rata_amount` number — Amount charged (positive) or credited (negative).
    - `credits_applied` number
    - `balance_applied` number
    - `new_monthly_price` number
    - `new_price_per_hour` string

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required
- `402` — Account balance is insufficient for this operation. Top up the balance and retry.
- `404` — Resource not found

## Changes

- **2026-05-06** `9e13a6e23934` — 1 info
  - added the media type `application/json` for the response with the status `402`
- **2026-03-20** `51e2355a0abe` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/rafftechnologies/apis/raff-api/changes/api/v1/volumes/:id/patch.md)

---

[API](https://skmtc.dev/rafftechnologies/apis/raff-api.md) · [All operations](https://skmtc.dev/rafftechnologies/apis/raff-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rafftechnologies/raff-api/revisions/2f4df56be77c/schema)