Client

​

Constructor

new Client(options: ClientConfig = {}): Client

Configuration options for the HoneyHive API client. They extend the options from openapi-fetch, but replace ‘baseUrl’ with ‘dataPlaneUrl’ so the name is unambiguous now that the SDK can also talk to the HoneyHive control plane.

​

Properties

​

apiKey?

optional apiKey?: string

​

Deprecated

Use projectApiKey instead. The old name will be removed in the next major version. Setting this option still works but logs a deprecation warning to stderr on client construction.

---

​

dataPlaneUrl?

optional dataPlaneUrl?: string

---

​

headers?

optional headers?: Record<string, string>

---

​

ingestionApiKey?

optional ingestionApiKey?: string

An ingestion API key (hh_ingst_…), the credential for sending traces and events: creating sessions and writing events. Defaults to the HH_INGESTION_API_KEY environment variable. A process that only sends traces and events holds this key alone; every other operation then behaves as it does on a client with no project API key configured. A value that is set but is not an ingestion key throws at construction. For compatibility, a client with a project API key and no ingestion key sends the project key on the ingestion operations too.

---

​

middleware?

optional middleware?: Middleware[]

---

​

projectApiKey?

optional projectApiKey?: string

---

​

serverUrl?

optional serverUrl?: string

​

Deprecated

Use dataPlaneUrl instead. The old name will be removed in the next major version. Setting this option still works but logs a deprecation warning to stderr on client construction.

---

​

verbose?

optional verbose?: boolean

When true, logs the resolved API URL, the masked API keys, and the SDK package + version via console.error on client construction (stderr in Node, devtools in the browser). Useful for confirming which environment, credentials, and SDK build the client is configured with. Defaults to true when the HH_VERBOSE environment variable is set to 'true' (case-insensitive).

---