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

# Create Volume

`POST /v1/volumes`

## Request

- Base URL: `https://api.anchorbrowser.io`
- URL: `https://api.anchorbrowser.io/v1/volumes`
- Auth: API key in header `anchor-api-key`

Create a persistent volume for your team. The volume is usually `ready` immediately; if the response says `creating`, poll `GET /v1/volumes/{volume_id}` until it is. Each team can have up to 10 volumes.

## Request body

- object
  - `name` string, required: Volume name, unique within your team. Letters, numbers, `_` and `-`, up to 64 characters.

## Response `200`

Volume created

- VolumeResponse
  - `data` VolumeResponseSchema
    - `id` string, uuid: Unique identifier for the volume. Use it in `browser.volume.id` when creating a session.
    - `name` string: Volume name, unique within your team
    - `state` 'creating' | 'ready' | 'deleting' | 'deleted' | 'error': Lifecycle state. Only `ready` volumes can be mounted or written to.
    - `error_reason` string, nullable: Why the volume entered the `error` state, if it did
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `last_used_at` string, date-time, nullable: Last time the volume was mounted into a session
    - `deleted_at` string, date-time, nullable

## Other responses

- `400`: Invalid name
- `403`: Volumes are not enabled for this team
- `409`: A volume with this name already exists, or the team reached its volume limit

## Changes

- **2026-10-16** `b3bfdb98c79e`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api.md) - [All operations](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/anchorbrowser/apis/anchorbrowser-api/revisions/9d755f22df0e?raw)