# Datasets

A Dataset represents a collection of related events that come from the same source, or are related to the same source.

This API allows you to list, create, and update datasets.



## Create a Dataset

 - [POST /1/datasets](https://api-docs.honeycomb.io/api/datasets/createdataset.md): Create a Dataset in the environment associated with your API key.
If a Dataset already exists by that name (or slug), then the existing dataset will be returned.


## List All Datasets

 - [GET /1/datasets](https://api-docs.honeycomb.io/api/datasets/listdatasets.md): Lists all Datasets for an environment.
: For Honeycomb Classic users, all datasets in Classic are returned.


## Get a Dataset

 - [GET /1/datasets/{datasetSlug}](https://api-docs.honeycomb.io/api/datasets/getdataset.md): Get a single Dataset by slug.


## Delete a Dataset

 - [DELETE /1/datasets/{datasetSlug}](https://api-docs.honeycomb.io/api/datasets/deletedataset.md): Deletes the Dataset. This is an irreversible operation.
It may take several minutes for the deletion process to complete.


: This endpoint will allow anyone with an API key that has the
manage dataset permission to delete any dataset in the environment (or
any dataset in the whole team for Classic customers).


Datasets with Deletion Protection enabled cannot be deleted.

To delete a Dataset with Deletion Protection enabled, first disable Deletion Protection by updating the Dataset with .


## Update a Dataset

 - [PUT /1/datasets/{datasetSlug}](https://api-docs.honeycomb.io/api/datasets/updatedataset.md): Update a Dataset's settings.