---
title: Update a token
description: Update API tokens’ descriptions in InfluxDB using the InfluxDB UI.
url: https://docs.influxdata.com/influxdb3/cloud-serverless/admin/tokens/update-tokens/
estimated_tokens: 2356
product: InfluxDB Cloud Serverless
version: cloud-serverless
---

# Update a token

Update an API token’s description and status using the InfluxDB user interface (UI), `influx` CLI, or InfluxDB API.

-   [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)

<!-- Tabbed content: Select one of the following options -->

**InfluxDB UI:**

## Update a token in the InfluxDB UI

To update tokens in the InfluxDB UI, navigate to the **API Tokens** management page. In the navigation menu on the left, select **Load Data** > **API Tokens**.

Load Data

-   [Update a token’s description](#update-a-tokens-description)
-   [Enable or disable a token in the InfluxDB UI](#enable-or-disable-a-token-in-the-influxdb-ui)

### Update a token’s description

1. On the [token management page](#update-a-token-in-the-influxdb-ui), click the pencil icon () next to the token’s description.
2. Update the token description, and then click anywhere else to save.

### Enable or disable a token in the InfluxDB UI

1. On the [token management page](#update-a-token-in-the-influxdb-ui), find the token that you would like to enable or disable.
2. Click the token description.
3. Click the **Active** toggle.

**influx CLI:**

## Enable a token using the influx CLI

Use the [`influx auth active` command](/influxdb3/cloud-serverless/reference/cli/influx/auth/active) to activate a token.

Provide the following flags:

-   `--token`: API token with permission to update authorizations
-   `--id`: Authorization ID to enable (available in the output of [`influx auth list`](/influxdb3/cloud-serverless/reference/cli/influx/auth/list))

```sh
influx auth active \
  --token API_TOKEN \
  --id AUTHORIZATION_ID
```

### Disable a token using the influx CLI

Use the [`influx auth inactive` command](/influxdb3/cloud-serverless/reference/cli/influx/auth/active) to deactivate a token.

Provide the following flags:

-   `--token`: API token with permission to update authorizations
-   `--id`: Authorization ID to disable (available in the output of [`influx auth list`](/influxdb3/cloud-serverless/reference/cli/influx/auth/list))

```sh
influx auth inactive \
  --token API_TOKEN \
  --id AUTHORIZATION_ID
```

**InfluxDB API:**

## 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 https://cloud2.influxdata.com/api/v2/authorizations/{AUTH\_ID}](/influxdb/v2/api/authorizations-api-tokens/)

Include the following in your request:

-   **Headers**:
    -   **Authorization**: `Token API_TOKEN` (API token with the [`write: authorizations`](/influxdb3/cloud-serverless/api/authorizations-api-tokens/#operation/PostAuthorizations) permission)
    -   **Content-type**: `application/json`
-   **Path parameters**:
    -   **authID**: Authorization ID to update
-   **Request body**: JSON object with [authorization properties](/influxdb3/cloud-serverless/admin/tokens/create-token/?t=InfluxDB+API#create-a-token-using-the-influxdb-api) to update

### Disable a token

```sh
# Update the description and status of the first authorization listed for the user.

curl --request GET \
  https://cloud2.influxdata.com/api/v2/authorizations?user=user2 \
  --header "Authorization: Token API_TOKEN" \
  --header 'Content-type: application/json' \
| jq .authorizations[0].id \
| xargs -I authid curl --request PATCH \
  https://cloud2.influxdata.com/api/v2/authorizations/authid \
  --header "Authorization: Token API_TOKEN" \
  --header 'Content-type: application/json' \
  --data '{
            "description": "deactivated_auth",
            "status": "inactive"
          }' | jq .
```

<!-- End tabbed content -->
