---
title: "Create Volume Session"
method: POST
path: "/api/v1/training/volumes/{name}/sessions"
tags: ["training"]
---

# Create Volume Session

`POST /api/v1/training/volumes/{name}/sessions`

## Request

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

## Path parameters

- `name` string, required

## Request body

- CreateVolumeSessionRequest
  - `teamId` string, nullable
  - `readOnly` boolean
  - `subPath` string, nullable
  - `allowWritable` boolean

## Response `201`

Successful Response

- VolumeSessionResponse
  - `id` string, required
  - `volumeName` string, required
  - `status` string, required
  - `readOnly` boolean, required
  - `sshConnection` string, nullable
  - `gateway` VolumeSessionGateway
    - `host` string, required
    - `port` integer, required
    - `certSha256` string, required
  - `hostPublicKey` string, nullable
  - `errorMessage` string, nullable
  - `createdAt` string, date-time, required
  - `phase` string, nullable
  - `progress` string, nullable
  - `liveViewOf` string, nullable

## Other responses

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

## Changes

> 49 revisions in range; 1 not diffed.

- **2026-10-29** `e96edafbde88`: 1 info
  - added the optional property `liveViewOf` to the response with the `201` status
- **2026-10-10** `4e60263f0880`: 2 info
  - added the optional property `phase` to the response with the `201` status
  - added the optional property `progress` to the response with the `201` status
- **2026-10-01** `78a0717641d2`: 1 info
  - added the required property `createdAt` to the response with the `201` status
- **2026-09-30** `c1cabd778280`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/primeintellect/apis/pi-api/changes/api/v1/training/volumes/:name/sessions/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)