> For the complete documentation index, see [llms.txt](https://hyperhq.gitbook.io/docs-hyper-sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperhq.gitbook.io/docs-hyper-sh/index-2/index-1/index/index-4/create.md).

# Create a volume

`POST /volumes/create`

Create a volume

**Example request**:

```
POST /volumes/create HTTP/1.1
Content-Type: application/json

{
  "Name": "tardis",
  "Driver": "hyper",
  "DriverOpts": {
      "size": "10",
      "snapshot":""
   }
}
```

**Example response**:

```
HTTP/1.1 201 Created
Content-Type: application/json

{
      "Name": "tardis",
      "Driver": "hyper",
      "Mountpoint": "",
      "Labels": {
          "size": "10",
          "snapshot": ""
      }
}
```

Status Codes:

* **201** - no error
* **500**  - server error

JSON Parameters:

* **Name** - The new volume's name. If not specified, Docker generates a name.
* **DriverOpts** - A json object containing:
  * **Size** - The size of the new volume. The value must be integar with the unit of GB, and valid value is from 10-1000 (1TB). Default, 10.
  * **Snapshot** - The Id of the snapshot to restore. Optional