Datasets and charts tools
Seven tools to read the datasets and charts a run builds: page through rows, download CSV, compare versions, and get charts as specs or SVG.
None of these use credits.
list_datasets
List the datasets in a project.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
get_dataset
Get a dataset with its rows a page at a time. Use total_rows, row_offset, and row_limit to page through.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
dataset_id required | string | Dataset UUID |
row_limit | integer | 1 to 2,000, default 50 |
row_offset | integer | Default 0 |
version | integer | A past version number. Omit for the latest. |
include_csv | boolean | Default false. True adds the same rows as CSV text. |
list_dataset_versions
List a dataset’s versions. Sleuth saves a new version when a dataset changes, for example after monitoring finds an update.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
dataset_id required | string | Dataset UUID |
download_dataset_csv
Download the whole dataset as CSV text. Large datasets make large results, so use get_dataset when a sample will do.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
dataset_id required | string | Dataset UUID |
version | integer | A past version number. Omit for the latest. |
list_artifacts
List the charts and other artifacts in a project.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
get_artifact
Get an artifact in full. Its artifact field is the chart spec.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
artifact_id required | string | Artifact UUID |
get_artifact_svg
Get an artifact rendered as SVG. Returns a 422 error for artifacts that aren’t visual.
| Input | Type | Notes |
|---|---|---|
project_id required | string | Project UUID |
artifact_id required | string | Artifact UUID |
Updated November 9, 2026