docs-v2/content/influxdb/cloud-dedicated/reference/cli/influxctl/token/update.md

title	description	menu	weight
influxctl token update	The `influxctl token update` command updates a database token with specified permissions to resources in an InfluxDB Cloud Dedicated cluster.	influxdb_cloud_dedicated parent influxctl token	301

The influxctl token update command updates a database token with specified permissions to resources in an InfluxDB Cloud Dedicated cluster.

Usage

influxctl token update \
  [--read-database=<DATABASE_NAME>] \
  [--write-database=<DATABASE_NAME>] \
  <TOKEN_ID>

{{% 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. {{% /note %}}

Arguments

Argument	Description
TOKEN_ID	Database token ID to update

Flags

Flag		Description
	--read-database	Grant read permissions to a database (Repeatable)
	--write-database	Grant write permissions to a database (Repeatable)
-h	--help	Output command help

Examples

• Update a token's permissions
• Update a token with read-only access to multiple databases
• Update a token with mixed permissions to multiple databases

In the examples below, replace the following:

• {{% code-placeholder-key %}}DATABASE_NAME{{% /code-placeholder-key %}}: your {{% cloud-name %}} database
• {{% code-placeholder-key %}}DATABASE2_NAME{{% /code-placeholder-key %}}: your {{% cloud-name %}} database
• {{% code-placeholder-key %}}TOKEN_ID{{% /code-placeholder-key %}}: token ID to update

Update a token's permissions

{{% code-placeholders "DATABASE_NAME|TOKEN_ID" %}}

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

{{% /code-placeholders %}}

Update a token with read-only access to multiple databases

{{% code-placeholders "DATABASE_NAME|DATABASE2_NAME|TOKEN_ID" %}}

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

{{% /code-placeholders %}}

Update a token with mixed permissions to multiple databases

{{% code-placeholders "DATABASE_NAME|DATABASE2_NAME|TOKEN_ID" %}}

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

{{% /code-placeholders %}}