# delete

## HTTP Request

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

## Path parameters

| Parameter        |                                                                                                                                                                                                                 |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| datasetReference | A qualified reference to the dataset. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information.                                                                     |
| tag              | <p>The version's tag, of the form <code>v1.0</code></p><p></p><p>Alternatively, you may specify <code>next</code> to delete the next (pending) version. The <code>current</code> version cannot be deleted.</p> |

{% hint style="info" %}
This endpoint extends the [general API structure](https://docs.redivis.com/api/rest-api/general-structure)
{% endhint %}

## Authorization

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

* data.edit

[Learn more about authorization.](https://docs.redivis.com/api/rest-api/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](https://docs.redivis.com/api/resource-definitions/version).