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

# datasets

> List, inspect, and manage datasets in your workspace

List, inspect, download, and delete datasets in your Landbase workspace.

## datasets list

List all datasets in your workspace.

**Usage**

```bash theme={null}
landbase-cli datasets list [flags]
```

**Flags**

| Flag | Default | Description |
| - | - | - |
| `--limit=<n>` | — | Maximum number of datasets to return |
| `--no-update-check` | — | Skip the daily update check |
| `--verbose` | — | Print request/response details to stderr |

***

## datasets show

Show details for a single dataset.

**Usage**

```bash theme={null}
landbase-cli datasets show <dataset-id> [flags]
```

**dataset-id** `string` *required*

The ID of the dataset to inspect.

**Flags**

| Flag | Default | Description |
| - | - | - |
| `--include-runs` | — | Include associated runs in the output |
| `--no-update-check` | — | Skip the daily update check |
| `--verbose` | — | Print request/response details to stderr |

***

## datasets lineage

Show the lineage graph for a dataset — the chain of parent and child datasets produced by workflow steps.

**Usage**

```bash theme={null}
landbase-cli datasets lineage <dataset-id> [flags]
```

**dataset-id** `string` *required*

The ID of the dataset whose lineage to display.

**Flags**

| Flag | Default | Description |
| - | - | - |
| `--workflow=<name>` | — | Filter by workflow type, e.g. `publish` |
| `--direction=children` | — | Show child datasets instead of parents |
| `--no-update-check` | — | Skip the daily update check |
| `--verbose` | — | Print request/response details to stderr |

***

## datasets download

Download a dataset to a local file.

**Usage**

```bash theme={null}
landbase-cli datasets download <dataset-id> <output-path>
```

**dataset-id** `string` *required*

The ID of the dataset to download.

**output-path** `string` *required*

Local file path for the downloaded file. Supported extensions: `.parquet`, `.csv`, `.jsonl.gz`, `.jsonl`.

***

## datasets delete

Delete a dataset.

**Usage**

```bash theme={null}
landbase-cli datasets delete <dataset-id> [flags]
```

**dataset-id** `string` *required*

The ID of the dataset to delete.

**Flags**

| Flag | Default | Description |
| - | - | - |
| `--yes` | — | Skip the confirmation prompt |
| `--no-update-check` | — | Skip the daily update check |
| `--verbose` | — | Print request/response details to stderr |

**Examples**

```bash theme={null}
# List all datasets
landbase-cli datasets list

# Show dataset details with runs
landbase-cli datasets show <dataset-id> --include-runs

# Show lineage of child datasets
landbase-cli datasets lineage <dataset-id> --direction=children

# Download as CSV
landbase-cli datasets download <dataset-id> ./output.csv

# Delete without confirmation
landbase-cli datasets delete <dataset-id> --yes
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.