OpenAPI Client (Any Language) - HoneyHive AI Docs

HoneyHive publishes a public OpenAPI specification that fully describes our REST API. 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 Spec (GitHub)

Browse the full OpenAPI specification.

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 client in your preferred language:

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

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/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/openapi.yaml \
  -g ruby \
  -o ./honeyhive-ruby-sdk

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

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

openapi-generator-cli generate \
  -i https://raw.githubusercontent.com/honeyhiveai/honeyhive-openapi/main/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

API Reference

Full endpoint reference

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.

OpenAPI Spec (GitHub)

​Why Generate Your Own Client

​Generating a Client

​Example: Using OpenAPI Generator

​When to Use What

​Next Steps