---
title: "Create volume"
method: POST
path: "/storage/volumes"
tags: ["Block Storage"]
---

# Create volume

`POST /storage/volumes`

Allows you to add persistent storage to a project. These volumes can be used to store data across your servers.

## Request body

- object
  - `data` object, required
    - `type` 'volumes', required
    - `attributes` object, required
      - `project` string, required — Project ID or slug
      - `name` string, required — Volume name
      - `size_in_gb` integer — Size in GB (not required, default is 1500)

## Response `201`

Created

## Other responses

- `503` — Service Unavailable - Storage creation temporarily frozen

## Changes

- **2026-08-05** `ae7dcb22727c` — 1 info
  - added the optional property `data/attributes/team/limits/prefix` to the response with the `201` status
- **2026-07-21** `885dec47dd47` — 6 info
  - added the optional property `data/attributes/cluster_user` to the response with the `201` status
  - added the optional property `data/attributes/keyring` to the response with the `201` status
  - added the optional property `data/attributes/project/stats/databases` to the response with the `201` status
  - added the optional property `data/attributes/project/stats/storages` to the response with the `201` status
  - …2 more

[Change history](https://skmtc.dev/latitude/apis/latitude-sh-api/changes/storage/volumes/post.md)

---

[API](https://skmtc.dev/latitude/apis/latitude-sh-api.md) · [All operations](https://skmtc.dev/latitude/apis/latitude-sh-api/llms.txt) · [OpenAPI document](https://skmtc.dev/latitude/apis/latitude-sh-api/revisions/6ad8dacf6642?raw)