> ## 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]
```

<ParamField path="dataset-id" type="string" required>
  The ID of the dataset to inspect.
</ParamField>

**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]
```

<ParamField path="dataset-id" type="string" required>
  The ID of the dataset whose lineage to display.
</ParamField>

**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>
```

<ParamField path="dataset-id" type="string" required>
  The ID of the dataset to download.
</ParamField>

<ParamField path="output-path" type="string" required>
  Local file path for the downloaded file. Supported extensions: `.parquet`, `.csv`, `.jsonl.gz`, `.jsonl`.
</ParamField>

***

## datasets delete

Delete a dataset.

**Usage**

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

<ParamField path="dataset-id" type="string" required>
  The ID of the dataset to delete.
</ParamField>

**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
```