---
title: "Create Pool"
method: POST
path: "/zfs/pools"
tags: ["ZFS"]
---

# Create Pool

`POST /zfs/pools`

Create a new ZFS pool

## Request body

- GithubComAlchemillahqSylveInternalInterfacesServicesZfsCreateZPoolRequest
  - `createForce` boolean
  - `mountpoint` string
  - `name` string, required
  - `properties` object
  - `spares` string[]
  - `vdevs` GithubComAlchemillahqSylveInternalInterfacesServicesZfsVdev[]
    - `devices` string[]
    - `name` string
    - `raidType` 'stripe' | 'mirror' | 'raidz' | 'raidz2' | 'raidz3'
    - `type` 'data' | 'log' | 'cache' | 'special' | 'dedup'

## Response `201`

Created

- GithubComAlchemillahqSylveInternalAPIResponseAny
  - `data` unknown
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.net/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.net/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alchemillahq/sylve-api/revisions/7a7bea85004e/schema)