---
title: "rent volume"
method: PUT
path: "/api/v0/volumes/"
tags: ["Volumes"]
---

# rent volume

`PUT /api/v0/volumes/`

Rent/create a new volume with specified parameters.

CLI Usage: `vastai create volume <id> --size <size_gb>`

## Request body

- object
  - `id` integer, required — ID for the volume
  - `size` integer — Size in GB (Defaults to 15)

## Response `200`

Success response

- object
  - `success` boolean
  - `volume_name` string — Name of the created/resized volume

---

[API](https://skmtc.net/vast/apis/vast-ai-api.md) · [All operations](https://skmtc.net/vast/apis/vast-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vast/vast-ai-api/revisions/4ed14f79f796/schema)