> ## Documentation Index
> Fetch the complete documentation index at: https://hyperbrowser.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Volumes

## Create a Volume

<CodeGroup>
  ```typescript Node.js theme={null}
  const created = await client.volumes.create({ name: "my-workspace" });
  console.log(created.id, created.name);
  ```

  ```python Python theme={null}
  from hyperbrowser.models import CreateVolumeParams

  created = client.volumes.create(CreateVolumeParams(name="my-workspace"))
  print(created.id, created.name)
  ```

  ```bash CLI theme={null}
  hx volume create my-workspace
  ```

  ```bash cURL theme={null}
  curl -X POST https://api.hyperbrowser.ai/api/volume \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "my-workspace"
    }'
  ```
</CodeGroup>

### Create Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-workspace",
  "size": 0,
  "transferAmount": 0
}
```

## List Volumes

<CodeGroup>
  ```typescript Node.js theme={null}
  const listed = await client.volumes.list();
  console.log(listed.volumes.length);
  ```

  ```python Python theme={null}
  listed = client.volumes.list()
  print(len(listed.volumes))
  ```

  ```bash CLI theme={null}
  hx volume list
  # alias: hx volume ls
  ```

  ```bash cURL theme={null}
  curl -X GET https://api.hyperbrowser.ai/api/volume \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

### List Response

```json theme={null}
{
  "volumes": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "my-workspace",
      "size": 0,
      "transferAmount": 0
    }
  ]
}
```

## Get a Volume

<CodeGroup>
  ```typescript Node.js theme={null}
  const volume = await client.volumes.get("550e8400-e29b-41d4-a716-446655440000");
  console.log(volume.id, volume.name);
  ```

  ```python Python theme={null}
  volume = client.volumes.get("550e8400-e29b-41d4-a716-446655440000")
  print(volume.id, volume.name)
  ```

  ```bash CLI theme={null}
  hx volume get <volume-id>
  ```

  ```bash cURL theme={null}
  curl -X GET https://api.hyperbrowser.ai/api/volume/VOLUME_ID \
    -H "x-api-key: YOUR_API_KEY"
  ```
</CodeGroup>

### Get Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "my-workspace"
}
```

## Next Step

* Continue to [Mounting Volumes](/sandboxes/volumes/mounting) to attach volumes to a sandbox.