API Reference

Deleting Datasets

Version: 4.0
Updated: 14th July 2024

Overview

Deleting a dataset will remove it from the catalogue and delete all associated resources. The complete dataset history will remain in the Audit Log.

Note

Uploaded files will be retained on the server for 90 days.

DELETE

https://data.website/api/v3/dataset/:id

Path Parameters

:id

5-character ID of the dataset, eg. "ab12x"

string

Required

HTTP Headers

Authorization

API key.

string

Required

HTTP Return Codes

200	JSON confirmation of deletion.
404	Dataset not found.
403	API key does not have editor permissions.

Example

import requests, json, os

dataset_id = "20abc"

headers = {"Authorization": os.getenv("DATAPRESS_API_KEY")}
url = f"https://data.website/api/v3/dataset/{dataset_id}"

response = requests.delete(url, headers=headers)
print(json.dumps(response.json(), indent=2))

{
  "id": "20abc",
  "deleted": true
}