Delete a Dataset

curl --request DELETE \
  --url https://api.honeycomb.io/1/datasets/{datasetSlug} \
  --header 'X-Honeycomb-Team: <api-key>'

{
  "error": "<string>"
}

Delete a Dataset

Deletes the Dataset. This is an irreversible operation. It may take several minutes for the deletion process to complete.

WARNING: 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 settings.delete_protected = false.

DELETE

datasets

{datasetSlug}

Delete a Dataset

curl --request DELETE \
  --url https://api.honeycomb.io/1/datasets/{datasetSlug} \
  --header 'X-Honeycomb-Team: <api-key>'

{
  "error": "<string>"
}

Authorizations

X-Honeycomb-Team

string

header

required

Authenticate using a Honeycomb Configuration Key.

Pass the Token in the X-Honeycomb-Team header:

X-Honeycomb-Team: 1234567890123456789012

If you created your key using the API, use data.attributes.secret; this is the same value as the Token in the UI.

To learn how to create a Configuration Key, visit Manage Environment API Keys. To learn more about authenticating requests, visit API Authentication.

Path Parameters

datasetSlug

string

required

The dataset slug.

Response

Deleted

Update a Dataset Create Events