# delete

## Overview

This endpoint is used to delete a table and all its contents. This method can only be called on tables belonging to unreleased versions of a dataset.

## HTTP Request

```http
DELETE /api/v1/tables/:tableReference
```

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

## Path parameters

| Parameter      |                                                                                                                                           |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| tableReference | A qualified reference to the table. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information. |

## Request body

The request body must be empty.

## Authorization

You must have edit access to this table's dataset. 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 successful, the response body will be empty.