Delete a database token
Use the influxctl
CLI
or the Management HTTP API
to delete a database token from your InfluxDB Cloud Dedicated cluster.
Use the influxctl token delete
command
to delete a database token from your InfluxDB Cloud Dedicated cluster and revoke
all permissions associated with the token.
If you haven’t already, download and install the
influxctl
CLI, and then configure aninfluxctl
connection profile for your cluster.To list token IDs, run the
influxctl token list
command in your terminal.influxctl token list
Copy the token ID of the token you want to delete.
Run the
influxctl token delete
command and provide the following:- Token ID to delete
Confirm that you want to delete the token.
influxctl token delete TOKEN_ID
This example uses cURL to send a Management HTTP API request, but you can use any HTTP client.
If you haven’t already, follow the instructions to install cURL for your system.
In your terminal, use cURL to send a request to the following InfluxDB Cloud Dedicated endpoint:
DELETE https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/tokens/TOKEN_ID
In the URL, provide the following:
ACCOUNT_ID
: The ID of the account that the cluster belongs to (see how to list cluster details).CLUSTER_ID
: The ID of the cluster that you want to manage (see how to list cluster details).TOKEN_ID
: The ID of the database token that you want to delete (see how to list token details).
Provide the following request headers:
Accept: application/json
to ensure the response body is JSON contentAuthorization: Bearer
and a Management API token for your cluster (see how to create a management token for Management API requests).
Specify the
DELETE
request method.
The following example shows how to use the Management API to delete a database token and revoke all permissions associated with the token:
curl \
--location "https://console.influxdata.com/api/v0/accounts/ACCOUNT_ID/clusters/CLUSTER_ID/tokens/TOKEN_ID" \
--request DELETE \
--header "Accept: application/json" \
--header "Authorization: Bearer $MANAGEMENT_TOKEN" \
Replace the following:
ACCOUNT_ID
: the ID of the InfluxDB Cloud Dedicated account to create the database token forCLUSTER_ID
: the ID of the InfluxDB Cloud Dedicated cluster to create the database token forMANAGEMENT TOKEN
: a management token for your InfluxDB Cloud Dedicated clusterTOKEN_ID
: the ID of the database token to delete
Deleting a token is immediate and cannot be undone
Deleting a database token is a destructive action that takes place immediately and cannot be undone.
Rotate deleted tokens
After deleting a database token, any clients using the deleted token need to be updated with a new database token to continue to interact with your InfluxDB Cloud Dedicated cluster.
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.