---
title: "Create Volume"
method: POST
path: "/api/v1/training/volumes"
tags: ["training"]
---

# Create Volume

`POST /api/v1/training/volumes`

## Request

- Base URL: `https://api.primeintellect.ai`
- URL: `https://api.primeintellect.ai/api/v1/training/volumes`
- Auth: HTTP bearer

## Request body

- CreateVolumeRequest
  - `name` string, required
  - `size` string
  - `teamId` string, nullable
  - `warm` boolean

## Response `201`

Successful Response

- VolumeResponse
  - `id` string, required
  - `name` string, required
  - `size` string, nullable, required
  - `status` string, required
  - `clusterId` string
  - `namespace` string
  - `pvcName` string
  - `createdBy` string, nullable, required
  - `createdByName` string, nullable
  - `createdByEmail` string, nullable
  - `createdAt` string, nullable, required
  - `priceHr` number, nullable
  - `usedBytes` integer, nullable
  - `lastSyncedAt` string, nullable

## Other responses

- `401`: Authorization failed
- `422`: Invalid request data

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-11-04** `7f032a9306b0`: 2 info
  - added the optional property `lastSyncedAt` to the response with the `201` status
  - added the optional property `usedBytes` to the response with the `201` status
- **2026-10-28** `1bb47742c56d`: 1 info
  - added the required property `id` to the response with the `201` status
- **2026-10-16** `81d59fc08a23`: 1 info
  - added the optional property `priceHr` to the response with the `201` status
- **2026-10-10** `4e60263f0880`: 2 breaking, 5 warning, 6 info
  - the response property `clusterId` became optional for the status `201`
  - the response property `pvcName` became optional for the status `201`
  - removed the request property `backend`
  - removed the request property `cluster`
  - …9 more
- **2026-10-03** `4789d1a26039`: 3 info
  - added the new optional request property `backend`
  - added the optional property `attachments` to the response with the `201` status
  - added the optional property `backend` to the response with the `201` status

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/training/volumes/post.md)

---

[API](https://skmtc.dev/primeintellect/apis/pi-api.md) - [All operations](https://skmtc.dev/primeintellect/apis/pi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/primeintellect/apis/pi-api/revisions/7f032a9306b0?raw)