---
title: Update a database token
description: Use the influxctl token update command to update a database token’s permissions in your InfluxDB cluster.
url: https://docs.influxdata.com/influxdb3/clustered/admin/tokens/database/update/
estimated_tokens: 752
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb3/clustered/admin/tokens/database/update/
date: '2026-05-15T15:46:14-06:00'
lastmod: '2026-05-15T15:46:14-06:00'
---

Use the [`influxctl token update` command](/influxdb3/clustered/reference/cli/influxctl/token/update/)to update a database token’s permissions in your InfluxDB cluster.

1. If you haven’t already, [download and install the `influxctl` CLI](/influxdb3/clustered/reference/cli/influxctl/#download-and-install-influxctl).

2. Run the `influxctl token create` command and provide the following:

   * Token permissions (read and write)

     * `--read-database`: Grants read permissions to the specified database. Repeatable.
     * `--write-database`: Grants write permissions to the specified database. Repeatable.

     Both of these flags support the `*` wildcard which grants read or write
     permissions to all databases. Enclose wildcards in single or double
     quotes–for example: `'*'` or `"*"`.

   * Token ID

```sh
influxctl token create \
  --read-database DATABASE_NAME \
  --write-database DATABASE_NAME \
  TOKEN_ID
```

Replace the following:

* `DATABASE_NAME`: your InfluxDB Clustered database
* `TOKEN ID`: ID of the token to update

> [!Note]
> #### Existing permissions are replaced on update
>
> When updating token permissions, the existing permissions are replaced by the
> new permissions specified in the update command.
> To retain existing permissions, include them in the update command.

### Examples

* [Update a token with read and write access to a database](#update-a-token-with-read-and-write-access-to-a-database)
* [Update a token with read and write access to all databases](#update-a-token-with-read-and-write-access-to-all-databases)
* [Update a token with read-only access to a database](#update-a-token-with-read-only-access-to-a-database)
* [Update a token with read-only access to multiple databases](#update-a-token-with-read-only-access-to-multiple-databases)
* [Update a token with mixed permissions to multiple databases](#update-a-token-with-mixed-permissions-to-multiple-databases)

In the examples below, Replace the following:

* `DATABASE_NAME`: your InfluxDB Clustered database
* `DATABASE2_NAME`: your InfluxDB Clustered database
* `TOKEN ID`: ID of the token to update

#### Update a token with read and write access to a database

```sh
influxctl token update \
  --read-database DATABASE_NAME \
  --write-database DATABASE_NAME \
  TOKEN_ID
```

#### Update a token with read and write access to all databases

```sh
influxctl token update \
  --read-database "*" \
  --write-database "*" \
  TOKEN_ID
```

#### Update a token with read-only access to a database

```sh
influxctl token update \
  --read-database DATABASE_NAME \
  TOKEN_ID
```

#### Update a token with read-only access to multiple databases

```sh
influxctl token update \
  --read-database DATABASE_NAME \
  --read-database DATABASE2_NAME \
  TOKEN_ID
```

#### Update a token with mixed permissions to multiple databases

```sh
influxctl token update \
  --read-database DATABASE_NAME \
  --read-database DATABASE2_NAME \
  --write-database DATABASE2_NAME \
  TOKEN_ID
```