docs-v2/content/influxdb/cloud/admin/secrets/add.md

title	description	influxdb/cloud/tags	menu	weight	aliases
Add secrets	Add secrets using the InfluxDB Cloud UI, `influx` CLI, or the InfluxDB API.	secrets security	influxdb_cloud parent Manage secrets	301	/influxdb/cloud/security/secrets/manage-secrets/add/ /influxdb/cloud/security/secrets/add/

Add secrets using the {{< product-name "short" >}} UI, influx command line interface (CLI) or the InfluxDB API.

• Add a secret using the InfluxDB Cloud UI
• Add a secret using the influx CLI
• Add a secret using the InfluxDB API

Add a secret using the InfluxDB Cloud UI

1. In the {{< product-name "short" >}} UI, click Settings.

   {{< nav-icon "settings" >}}

2. Click the Secrets tab.

3. Click Add Secret.

4. Enter a key and a value. {{% warn %}} Once the value is set, you will not be able to view the secret value again. It will only be accessible to your code through the secrets library. {{% /warn %}}

5. Click Add Secret.

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.

{{% warn %}} Providing a secret value with the -v or --value flag may expose the secret in your command history. {{% /warn %}}

# 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 -XPATCH https://cloud2.influxdata.com/api/v2/orgs/<org-id>/secrets \
  -H 'Authorization: Token YOUR_API_TOKEN' \
  -H 'Content-type: application/json' \
  --data '{
	"<secret-key>": "<secret-value>"
}'