---
title: "DELETE /projects/{+projectId}/datasets/{+datasetId}"
method: DELETE
path: "/projects/{+projectId}/datasets/{+datasetId}"
tags: ["datasets"]
---

# DELETE /projects/{+projectId}/datasets/{+datasetId}

`DELETE /projects/{+projectId}/datasets/{+datasetId}`

Deletes the dataset specified by the datasetId value. Before you can delete a dataset, you must delete all its tables, either manually or by specifying deleteContents. Immediately after deletion, you can create another dataset with the same name. # IAM Permissions Requires the `bigquery.datasets.delete` permission on the dataset.

## Path parameters

- `projectId` string, required
- `datasetId` string, required

## Query parameters

- `deleteContents` boolean

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/bigquery.md) · [All operations](https://skmtc.dev/google/apis/bigquery/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/bigquery/revisions/98f33ea9c8c9/schema)