---
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: 499
product: InfluxDB Cloud Dedicated
version: cloud-dedicated
---

# influxctl database rename

-   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).*