delete

HTTP Request

DELETE /api/v1/datasets/:datasetReference/versions/:tag

Path parameters

Parameter

datasetReference

A qualified reference to the dataset. See referencing resources for more information.

tag

The version's tag, of the form v1.0

Alternatively, you may specify next to delete the next (pending) version. The current version cannot be deleted.

This endpoint extends the general API structure

Authorization

Edit access to the dataset is required. Your access token must have the following scope:

  • data.edit

Learn more about authorization.

Response body

If the deleted version was a next version, it will be immediately deleted, and no body will be included in the response. If the deleted version is an historic version, it will be marked as isDeleted=true and returned as a JSON representation of a version.get resource.

Last updated