# Datasets

Dataset resources

## Operations

| Method | Path | Operation |
| --- | --- | --- |
| `GET` | `/v1/private/datasets` | [Find datasets](../finddatasets.md) |
| `POST` | `/v1/private/datasets` | [Create dataset](../createdataset.md) |
| `POST` | `/v1/private/datasets/delete` | [Delete dataset by name](../deletedatasetbyname.md) |
| `POST` | `/v1/private/datasets/delete-batch` | [Delete datasets](../deletedatasetsbatch.md) |
| `GET` | `/v1/private/datasets/export-jobs` | [Get all dataset export jobs](../getdatasetexportjobs.md) |
| `GET` | `/v1/private/datasets/export-jobs/{jobId}` | [Get dataset export job status](../getdatasetexportjob.md) |
| `GET` | `/v1/private/datasets/export-jobs/{jobId}/download` | [Download dataset export file](../downloaddatasetexport.md) |
| `PUT` | `/v1/private/datasets/export-jobs/{jobId}/mark-viewed` | [Mark dataset export job as viewed](../markdatasetexportjobviewed.md) |
| `PUT` | `/v1/private/datasets/items` | [Create/update dataset items](../createorupdatedatasetitems.md) |
| `PATCH` | `/v1/private/datasets/items/batch` | [Batch update dataset items](../batchupdatedatasetitems.md) |
| `POST` | `/v1/private/datasets/items/delete` | [Delete dataset items](../deletedatasetitems.md) |
| `POST` | `/v1/private/datasets/items/from-csv` | [Create dataset items from CSV file](../createdatasetitemsfromcsv.md) |
| `POST` | `/v1/private/datasets/items/from-json` | [Create dataset items from JSON file](../createdatasetitemsfromjson.md) |
| `POST` | `/v1/private/datasets/items/stream` | [Stream dataset items](../streamdatasetitems.md) |
| `GET` | `/v1/private/datasets/items/{itemId}` | [Get dataset item by id](../getdatasetitembyid.md) |
| `PATCH` | `/v1/private/datasets/items/{itemId}` | [Partially update dataset item by id](../patchdatasetitem.md) |
| `POST` | `/v1/private/datasets/retrieve` | [Get dataset by name](../getdatasetbyidentifier.md) |
| `POST` | `/v1/private/datasets/{dataset_id}/items/from-spans` | [Create dataset items from spans](../createdatasetitemsfromspans.md) |
| `POST` | `/v1/private/datasets/{dataset_id}/items/from-traces` | [Create dataset items from traces](../createdatasetitemsfromtraces.md) |
| `DELETE` | `/v1/private/datasets/{id}` | [Delete dataset by id](../deletedataset.md) |
| `GET` | `/v1/private/datasets/{id}` | [Get dataset by id](../getdatasetbyid.md) |
| `PUT` | `/v1/private/datasets/{id}` | [Update dataset by id](../updatedataset.md) |
| `POST` | `/v1/private/datasets/{id}/expansions` | [Expand dataset with synthetic samples](../expanddataset.md) |
| `POST` | `/v1/private/datasets/{id}/export` | [Start dataset CSV export](../startdatasetexport.md) |
| `GET` | `/v1/private/datasets/{id}/items` | [Get dataset items](../getdatasetitems.md) |
| `POST` | `/v1/private/datasets/{id}/items/changes` | [Apply changes to dataset items](../applydatasetitemchanges.md) |
| `GET` | `/v1/private/datasets/{id}/items/experiments/items` | [Find dataset items with experiment items](../finddatasetitemswithexperimentitems.md) |
| `GET` | `/v1/private/datasets/{id}/items/experiments/items/output/columns` | [Get dataset items output columns](../getdatasetitemsoutputcolumns.md) |
| `GET` | `/v1/private/datasets/{id}/items/experiments/items/stats` | [Get experiment items stats for dataset](../getdatasetexperimentitemsstats.md) |
| `GET` | `/v1/private/datasets/{id}/versions` | [List dataset versions](../listdatasetversions.md) |
| `GET` | `/v1/private/datasets/{id}/versions/diff` | [Compare latest version with draft](../comparedatasetversions.md) |
| `PATCH` | `/v1/private/datasets/{id}/versions/hash/{versionHash}` | [Update dataset version](../updatedatasetversion.md) |
| `POST` | `/v1/private/datasets/{id}/versions/hash/{versionHash}/tags` | [Create version tag](../createversiontag.md) |
| `POST` | `/v1/private/datasets/{id}/versions/restore` | [Restore dataset to a previous version](../restoredatasetversion.md) |
| `POST` | `/v1/private/datasets/{id}/versions/retrieve` | [Retrieve dataset version by name](../retrievedatasetversion.md) |
| `DELETE` | `/v1/private/datasets/{id}/versions/{versionHash}/tags/{tag}` | [Delete version tag](../deleteversiontag.md) |

## Related pages

- [Activate a pairing session](../activatepairingsession.md)
- [Add blueprint to existing config](../updateagentconfig.md)
- [Add items to annotation queue](../additemstoannotationqueue.md)
- [Add span comment](../addspancomment.md)
- [Add span feedback score](../addspanfeedbackscore.md)
- [Add thread comment](../addthreadcomment.md)
- [Add trace comment](../addtracecomment.md)
- [Add trace feedback score](../addtracefeedbackscore.md)
- [Agent Configs](./agent-configs.md)
- [Agent Insights](./agent-insights.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.