---
title: influxctl database rename
description: The influxctl database rename command renames a database in an InfluxDB Cloud Dedicated cluster.
url: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/database/rename/
estimated_tokens: 331
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/database/rename/
date: '2025-06-30T15:05:37-06:00'
lastmod: '2025-06-30T15:05:37-06:00'
---

* influxctl 2.10.2+

The `influxctl database rename` command renames a database in an
InfluxDB Cloud Dedicated cluster.
This command does *not* change the database ID, database properties, or the
data stored in the database.

#### Renaming a database requires new tokens

[Database tokens](/influxdb3/cloud-dedicated/admin/tokens/database/) are associated to
databases by name. After renaming a database, tokens referencing the old name
no longer function. You must generate tokens for the new database name.

## Usage

```bash
influxctl database rename [flags] <CURRENT_DB_NAME> <NEW_DB_NAME>
```

## Arguments

|      Argument       |        Description         |
|---------------------|----------------------------|
|**CURRENT\_DB\_NAME**|Current name of the database|
|  **NEW\_DB\_NAME**  | New name for the database  |

## Flags

|Flag|        |    Description    |
|----|--------|-------------------|
|`-h`|`--help`|Output command help|

*Also see [`influxctl` global flags](/influxdb3/cloud-dedicated/reference/cli/influxctl/#global-flags).*
| Argument | Description |
| --- | --- |
| Argument | Description |
| CURRENT_DB_NAME | Current name of the database |
| NEW_DB_NAME | New name for the database |

| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
| -h | --help | Output command help |