---
title: Update a token
description: Update API tokens’ descriptions in InfluxDB using the InfluxDB UI.
url: https://docs.influxdata.com/influxdb/v2/admin/tokens/update-tokens/
estimated_tokens: 1148
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/admin/tokens/update-tokens/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

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

* [Update a token in the InfluxDB UI](#update-a-token-in-the-influxdb-ui)
* [Enable or disable a token in the InfluxDB UI](#enable-or-disable-a-token-in-the-influxdb-ui)
* [Enable a token using the influx CLI](#enable-a-token-using-the-influx-cli)
* [Disable a token using the influx CLI](#disable-a-token-using-the-influx-cli)
* [Update a token using the InfluxDB API](#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**.

Load Data

1. Click the pencil icon  next to the token’s name in the **Description** column.
2. 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**.

Load Data

1. Click the  **Status** toggle.

## Enable a token using the influx CLI

Use the [`influx auth active` command](/influxdb/v2/reference/cli/influx/auth/active)to activate a token.

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

```sh
# 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](/influxdb/v2/reference/cli/influx/auth/list).

```sh
influx auth find --json
```

### Disable a token using the influx CLI

Use the [`influx auth inactive` command](/influxdb/v2/reference/cli/influx/auth/active)to deactivate a token.

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

```sh
# 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](/influxdb/v2/reference/cli/influx/auth/list).

```sh
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:

|                                            Requirement                                             |                     Include by                      |
|----------------------------------------------------------------------------------------------------|-----------------------------------------------------|
|API token with the [`write: authorizations`](/influxdb/v2/api/authorizations-api-tokens/) permission|Use the `Authorization: Token YOUR_API_TOKEN` header.|
|                                          Authorization ID                                          |                 URL path parameter.                 |
|                                     Description and/or Status                                      |Pass as `description`, `status` in the request body. |

### Disable a token

```sh
# 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 .
```
| Requirement | Include by |
| --- | --- |
| Requirement | Include by |
| API token with the  write: authorizations  permission | Use the  Authorization: Token YOUR_API_TOKEN  header. |
| Authorization ID | URL path parameter. |
| Description and/or Status | Pass as  description ,  status  in the request body. |