OpenAPI Client (Any Language)

HoneyHive publishes public OpenAPI specifications that fully describe our REST APIs: a Data Plane spec (events, sessions, datasets, experiments - the API most integrations use) and a Control Plane spec (projects and alerts). Your platform team can use any open-source client generator to produce a lightweight, type-safe client in the language of their choice - no vendor-specific dependencies required.

OpenAPI Specs (GitHub)

Browse the full OpenAPI specifications.

Why Generate Your Own Client

Generated OpenAPI clients have no external dependencies beyond your language’s standard HTTP libraries, making them ideal for:

Any language - Go, Java, Ruby, Rust, C#, PHP, or any language with an OpenAPI generator
Serverless environments - AWS Lambda, Google Cloud Functions, Azure Functions where package size matters
Regulated environments - Industries with strict security requirements where adding dependencies is difficult
Full control - Customize the generated code, extend it, or integrate it directly into your existing codebase

Generating a Client

You can use any OpenAPI-compatible code generator. We recommend OpenAPI Generator, which supports 50+ languages (Java, Go, Ruby, Rust, C#, PHP, and more).

Example: Using OpenAPI Generator

First, install the OpenAPI Generator CLI:

npm install @openapitools/openapi-generator-cli -g

Then generate a Data Plane client in your preferred language. To generate a Control Plane client instead, swap data_plane_openapi.yaml for control_plane_openapi.yaml.

A Control Plane client authenticates differently than these Data Plane examples: it needs a fine-grained control-plane API key (values start with hh_fgcp_) sent as Authorization: Bearer, against https://api.cp.us.honeyhive.ai. See Authorization.

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g go \
  -o ./honeyhive-go-sdk

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g java \
  -o ./honeyhive-java-sdk \
  --additional-properties=library=okhttp-gson

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g ruby \
  -o ./honeyhive-ruby-sdk

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g csharp \
  -o ./honeyhive-csharp-sdk

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g rust \
  -o ./honeyhive-rust-sdk

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/data_plane_openapi.yaml \
  -g php \
  -o ./honeyhive-php-sdk

The generated client will include typed models, API methods, and authentication handling based on the spec. You can then vendor the generated code directly into your project or publish it as an internal package.

When to Use What

Approach	Best For
Generated OpenAPI client	Teams using languages beyond Python, strict dependency policies, serverless environments, or wanting full control over the client
HoneyHive Tracer SDK	Python teams wanting automatic instrumentation with OpenTelemetry, auto-captured LLM calls, and built-in context propagation
TypeScript API Client	TypeScript / Node.js teams wanting a typed REST client for tracing, datasets, and experiments
Direct REST API calls	Quick prototyping, one-off scripts, or when you already have an HTTP client configured

Next Steps

These guides cover the endpoint workflows for tracing and evaluation:

Tracing via API

Log sessions and events via REST

Experiments via API

Run evaluation experiments via REST

Data Plane API Reference

Full endpoint reference for events, sessions, datasets, experiments, prompts, and metrics

Control Plane API Reference

Full endpoint reference for projects and alerts

First-Party SDKs

HoneyHive maintains first-party Python and TypeScript SDKs.

Python SDK

First-party Python SDK with OpenTelemetry tracing and auto-instrumentation.

TypeScript API SDK

Type-safe TypeScript client for the HoneyHive REST API.

Python SDK

TypeScript API SDK

TypeScript Control Plane SDK

Semantic Conventions

OpenAPI Client

OpenAPI Specs (GitHub)

Why Generate Your Own Client

Generating a Client

Example: Using OpenAPI Generator

When to Use What

Next Steps

Tracing via API

Experiments via API

Data Plane API Reference

Control Plane API Reference

First-Party SDKs

Python SDK

TypeScript API SDK

OpenAPI Specs (GitHub)

​Why Generate Your Own Client

​Generating a Client

​Example: Using OpenAPI Generator

​When to Use What

​Next Steps

Tracing via API

Experiments via API

Data Plane API Reference

Control Plane API Reference

​First-Party SDKs

Python SDK

TypeScript API SDK

Why Generate Your Own Client

Generating a Client

Example: Using OpenAPI Generator

When to Use What

Next Steps

First-Party SDKs