Environment Variables - HoneyHive AI Docs

The CLI reads the following environment variables. All are optional, and each can be overridden by a root-level flag, which takes precedence over its environment variable.

Configuration

Variable	Description	Default	Override flag
`HH_PROJECT_API_KEY`	Project API key for authenticating with HoneyHive. Required for every data plane command, except the ingestion commands when `HH_INGESTION_API_KEY` is set. The control plane commands never use it.	None	`--project-api-key <key>`
`HH_INGESTION_API_KEY`	Ingestion API key (`hh_ingst_`) for the commands that create sessions and create or update events. Other commands never use it, and a run that has only this key is rejected with an error naming the project API key they need.	None	`--ingestion-api-key <key>`
`HH_CONTROL_PLANE_API_KEY`	Fine-grained API key (`hh_fgcp_`) for the control plane commands: `projects`, `alerts`, `workspaces`, and `virtual-dataplanes`. Data plane commands never use it.	None (required for those commands)	`--control-plane-api-key <key>`
`HH_DATA_PLANE_URL`	Base URL for the Data Plane API.	`https://api.dp1.us.honeyhive.ai`	`--data-plane-url <url>`
`HH_CONTROL_PLANE_URL`	Base URL for the Control Plane API, used by the control plane commands.	`https://api.cp.us.honeyhive.ai`	`--control-plane-url <url>`
`HH_VERBOSE`	Set to `"true"` (case-insensitive) to log the resolved URL for the command’s plane, its masked API keys, and the CLI version on startup.	`false`	`--verbose`

An empty string is treated the same as unset, so HH_PROJECT_API_KEY= honeyhive ... falls back to the default (or errors when the command has no API key of a kind it accepts).

Deprecated aliases

These names are still accepted but will be removed in the next major version. Using any of them logs a deprecation warning to stderr.

Deprecated	Replacement
`HH_API_KEY`	`HH_PROJECT_API_KEY`
`HH_API_URL`	`HH_DATA_PLANE_URL`
`--api-key <key>`	`--project-api-key <key>`
`--base-url <url>`	`--data-plane-url <url>`

Resolution runs new flag → deprecated flag → new environment variable → deprecated environment variable, so a deprecated name only takes effect when no current one resolved. A deprecated flag warns whenever you pass it, even when its replacement wins resolution, so a script passing both is still told to drop the old one.

There is no HONEYHIVE_* prefix in the CLI. Unlike the Python SDK, only the HH_* names above are recognized.