---
title: influxctl table rename
description: The influxctl table rename command renames a table in an InfluxDB Cloud Dedicated cluster.
url: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename/
estimated_tokens: 369
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/cloud-dedicated/reference/cli/influxctl/table/rename/
date: '2025-08-01T23:43:54-05:00'
lastmod: '2025-08-01T23:43:54-05:00'
---

* influxctl 2.10.3+

The `influxctl table rename` command renames a table in the specified database in
an InfluxDB Cloud Dedicated cluster.

## Usage

```bash
influxctl table rename [flags] <DATABASE_NAME> <CURRENT_TABLE_NAME> <NEW_TABLE_NAME>
```

## Arguments

|        Argument        |            Description             |
|------------------------|------------------------------------|
|   **DATABASE\_NAME**   |Name of the database the table is in|
|**CURRENT\_TABLE\_NAME**|     Current name of the table      |
|  **NEW\_TABLE\_NAME**  |       New name for the table       |

## Flags

|Flag|          |                 Description                 |
|----|----------|---------------------------------------------|
|    |`--format`|Output format (`table` *(default)* or `json`)|
|`-h`| `--help` |             Output command help             |

*Also see [`influxctl` global flags](/influxdb3/cloud-dedicated/reference/cli/influxctl/#global-flags).*

## Examples

```bash
# Rename the "example-tb" table to "example_tb"
influxctl table rename mydb example-tb example_tb
```
| Argument | Description |
| --- | --- |
| Argument | Description |
| DATABASE_NAME | Name of the database the table is in |
| CURRENT_TABLE_NAME | Current name of the table |
| NEW_TABLE_NAME | New name for the table |

| Flag |  | Description |
| --- | --- | --- |
| Flag |  | Description |
|  | --format | Output format ( table   (default)  or  json ) |
| -h | --help | Output command help |