# pool.dataset.delete

Delete dataset/zvol `id`.

Delete “tank/myuser” dataset:

    {
        "jsonrpc": "2.0",
        "id": 1,
        "method": "pool.dataset.delete",
        "params": ["tank/myuser"]
    }

Type: object

##

Type: array
No Additional Items

#### Tuple Validation

##### Parameter 1: id

#### id

Type: string

The dataset ID (full path) to delete.

##### Parameter 2: options

#### options

Type: object

Options controlling the deletion behavior such as recursive and force flags.

No Additional Properties

##

#### Recursive

Type: boolean Default: false

Also delete/destroy all children datasets. When root dataset is specified as `id` with `recursive`, it will destroy all the children of the root dataset present leaving root dataset intact.

##

#### Force

Type: boolean Default: false

Delete datasets even if they are busy.

##

#### Result

Type: enum (of boolean or null)

Return true on successful deletion or null if the `zfs destroy` command fails with "dataset does not exist".

##### Must be one of:

- null
- true

Required roles: DATASET_DELETE