InfluxDB Docs

Manage secrets

Manage secrets using the InfluxDB /org/{orgID}/secrets API endpoint. All secrets belong to an organization and are stored in your secret-store. Include your organization ID and authentication token with each request.

Add a secret

Use the PATCH request method to add a new secret to your organization. Pass the secret key-value pair in the request body.

curl -XPATCH http://localhost:9999/api/v2/orgs/<org-id>/secrets \
  -H 'authorization: Token YOURAUTHTOKEN' \
  -H 'Content-type: application/json' \
  --data '{
	"<secret-key>": "<secret-value>"

View secret keys

Use the GET request method to view your organization’s secrets keys.

curl -XGET http://localhost:9999/api/v2/orgs/<org-id>/secrets \
  -H 'authorization: Token YOURAUTHTOKEN'

Delete a secret

Use the POST request method and the orgs/{orgID}/secrets/delete API endpoint to delete one or more secrets. Include an array of secret keys to delete in the requests body in the following format.

curl -XGET http://localhost:9999/api/v2/orgs/<org-id>/secrets/delete \
  --H 'authorization: Token YOURAUTHTOKEN'
  --data '{
  "secrets": [

Use secrets in a query

Import the influxdata/influxd/secrets package and use the secrets.get() function to populate sensitive data in queries with secrets from your secret store.

import "influxdata/influxdb/secrets"
import "sql"

username = secrets.get(key: "POSTGRES_USERNAME")
password = secrets.get(key: "POSTGRES_PASSWORD")

  driverName: "postgres",
  dataSourceName: "postgresql://${username}:${password}@localhost",
  query:"SELECT * FROM example-table"