---
title: "Add volume"
method: POST
path: "/volumes"
tags: ["volumes"]
---

# Add volume

`POST /volumes`

Creates a new storage volume at the specified path with the given sector capacity.

## Request body

- AddVolumeRequest
  - `localPath` string, required — Absolute filesystem path where the volume data will be stored.
  - `maxSectors` integer, required — Initial number of sectors the volume can store. Each sector is 4 MiB.

## Response `200`

Volume added.

- Volume
  - `id` integer, required — Unique identifier of the volume.
  - `localPath` string, required — Absolute filesystem path of the volume data.
  - `usedSectors` integer, required — Number of sectors currently stored in the volume.
  - `totalSectors` integer, required — Maximum number of sectors the volume can store.
  - `readOnly` boolean, required — Whether the volume is read-only.
  - `available` boolean, required — Whether the volume is currently available for I/O operations.

---

[API](https://skmtc.dev/siafoundation/apis/hostd-api.md) · [All operations](https://skmtc.dev/siafoundation/apis/hostd-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/siafoundation/hostd-api/revisions/08ff756929fc/schema)