Add secrets

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

Add secrets using the influx command line interface (CLI) or the InfluxDB API.

Add a secret using the influx CLI

Use the influx secret update command to add a new secret to your organization. Provide the secret key with the -k or --key flag. You may also provide the secret value with the -v or --value flag. If you do not provide the secret value with the -v or --value flag, enter the value when prompted.

Providing a secret value with the -v or --value flag may expose the secret in your command history.

# Syntax
influx secret update -k <secret-key>

# Example
influx secret update -k foo

Add a secret using the InfluxDB API

Use the PATCH request method and the /orgs/{orgID}/secrets API endpoint to add a new secret to your organization.

Include the following:

  • Your organization ID in the request URL
  • Your API token in the Authorization header
  • The secret key-value pair in the request body
curl --request PATCH http://localhost:8086/api/v2/orgs/<org-id>/secrets \
  --header 'Authorization: Token YOURAUTHTOKEN' \
  --header 'Content-type: application/json' \
  --data '{
	"<secret-key>": "<secret-value>"

Was this page helpful?

Thank you for your feedback!

Set your InfluxDB URL

Introducing InfluxDB 3.0

The new core of InfluxDB built with Rust and Apache Arrow. Available today in InfluxDB Cloud Dedicated.

Learn more

State of the InfluxDB Cloud Serverless documentation

The new documentation for InfluxDB Cloud Serverless is a work in progress. We are adding new information and content almost daily. Thank you for your patience!

If there is specific information you’re looking for, please submit a documentation issue.