Update a token

Update an API token’s description and status. using the InfluxDB user interface (UI).

• Update a token in the InfluxDB UI
• Enable or disable a token in the InfluxDB UI
• Enable a token using the influx CLI
• Disable a token using the influx CLI
• Update a token using the InfluxDB API

Update a token in the InfluxDB UI

1. In the navigation menu on the left, select Data (Load Data) > API Tokens.

2. Click the pencil icon next to the token’s name in the Description column.
3. Update the token description, then click anywhere else to save.

Enable or disable a token in the InfluxDB UI

1. In the navigation menu on the left, select Data (Load Data) > API Tokens.

2. Click the Status toggle.

Enable a token using the influx CLI

Use the influx auth active command to activate a token.

This command requires an authorization ID, which is available in the output of influx auth find.

# Syntax influx auth active -i <auth-id>  # Example influx auth active -i 0804f74142bbf000

To get the current status of a token, use the JSON output of the influx auth list command.

influx auth find --json

Disable a token using the influx CLI

Use the influx auth inactive command to deactivate a token.

This command requires an authorization ID, which is available in the output of influx auth find.

# Syntax influx auth inactive -i <auth-id>  # Example influx auth inactive -i 0804f74142bbf000

To get the current status of a token, use the JSON output of the influx auth list command.

influx auth find --json

Update a token using the InfluxDB API

Use the /api/v2/authorizations InfluxDB API endpoint to update the description and status of a token.

PATCH http://localhost:8086/api/v2/authorizations/AUTH_ID

Include the following in your request:

Disable a token

# Update the description and status of the first authorization listed for the user.  curl --request GET \  "http://localhost:8086/api/v2/authorizations?user=user2" \  --header "Authorization: Token ${INFLUX_TOKEN}" \  --header 'Content-type: application/json' \ | jq .authorizations[0].id \ | xargs -I authid curl --request PATCH \  http://localhost:8086/api/v2/authorizations/authid \  --header "Authorization: Token ${INFLUX_TOKEN}" \  --header 'Content-type: application/json' \  --data '{  "description": "deactivated_auth",  "status": "inactive"  }' | jq .