---
title: Undelete a database
description: Use the influxctl database undelete command to restore a previously deleted database in your InfluxDBed cluster.
url: https://docs.influxdata.com/influxdb3/clustered/admin/databases/undelete/
estimated_tokens: 569
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/admin/databases/undelete/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

Use the [`influxctl database undelete` command](/influxdb3/clustered/reference/cli/influxctl/database/undelete/)to restore a previously deleted database in your InfluxDBed cluster.

> [!Important]
> To undelete a database:
> * The database name must match the name of the deleted database.
> * A new database with the same name cannot already exist.
> * You must have appropriate permissions to manage databases.

* The database name must match the name of the deleted database.
* A new database with the same name cannot already exist.
* You must have appropriate permissions to manage databases.

When you undelete a database, it is restored with the same retention period,
table limits, and column limits as when it was deleted.

> [!Warning]
> Databases can only be undeleted for

a configurable “hard-delete” grace period

>
>
> after they are deleted.
> After this grace period, all Parquet files associated with the deleted database
> are permanently removed and the database cannot be undeleted.
>
>

## Undelete a database using the influxctl CLI

```sh
influxctl database undelete DATABASE_NAME
```

Replace the following:

* `DATABASE_NAME`:
  Name of the deleted database to restore

## Recreate tokens for the database

After successfully undeleting a database:

1. **Verify the database was restored** by [listing all databases](/influxdb3/clustered/admin/databases/list/).
2. **If you previously deleted tokens associated with the deleted database, create new database tokens**
   * Any tokens that existed before deletion are not restored.[Create new database tokens](/influxdb3/clustered/admin/tokens/database/create/)with appropriate permissions for the restored database.

3. **Update your applications** to use the new database tokens.

#### Undeleted databases retain their original configuration

When a database is undeleted, it retains the same database ID, retention period,
and table/column limits it had before deletion. However, database tokens are not
restored and must be recreated.

#### Related

* [influxctl database undelete](/influxdb3/clustered/reference/cli/influxctl/database/undelete/)
* [Delete a database](/influxdb3/clustered/admin/databases/delete/)
* [Create a database token](/influxdb3/clustered/admin/tokens/database/create/)