# Datasets Create, ingest into, purge, and delete datasets; list and inspect ingestions. ## Create a dataset - [POST /v1/datasets](https://developers.databox.com/api/api.databox.com/datasets/datasets_postcreate.md): Creates a new dataset within the specified data source. A dataset acts as a container for ingested data and can later be populated with rows. Once created, the dataset can be used for reporting, visualizations, and transformations within the platform. Notes: - Requires a valid x-api-key with permission to manage datasets in the target account. - Each dataset must belong to an existing data source; it cannot exist independently. - The dataset is created empty; data is added afterward through ingestion events. ## Delete a dataset - [DELETE /v1/datasets/{datasetId}](https://developers.databox.com/api/api.databox.com/datasets/datasets_delete.md): Deletes the specified dataset. This action permanently removes all associated data and cannot be reversed. ## Purge a dataset - [POST /v1/datasets/{datasetId}/purge](https://developers.databox.com/api/api.databox.com/datasets/datasets_postpurge.md): Purges the specified dataset by removing all rows of data it contains. The dataset itself remains intact and can continue to receive new ingestions. This operation is irreversible — once purged, the deleted data cannot be restored. ## Create an ingestion - [POST /v1/datasets/{datasetId}/data](https://developers.databox.com/api/api.databox.com/datasets/datasets_postcreateingestion.md): Adds a batch of data records to the specified dataset through an ingestion event. You can include up to 100 records per ingestion event. The returned ingestionId values can be used with the corresponding ingestion details endpoint to retrieve more information the ingestion event. ## List ingestions - [GET /v1/datasets/{datasetId}/ingestions](https://developers.databox.com/api/api.databox.com/datasets/datasets_getlistingestions.md): Retrieves a list of ingestions events that have been created for the specified dataset. The returned ingestionId values can be used with the corresponding ingestion details endpoint to retrieve more information about a specific ingestion event. ## Retrieve an ingestion - [GET /v1/datasets/{datasetId}/ingestions/{ingestionId}](https://developers.databox.com/api/api.databox.com/datasets/datasets_getingestion.md): Retrieves detailed information for an ingestion event, allowing you to check processing progress and outcomes.