Skip to main content
HoneyHive publishes a public OpenAPI specification that fully describes our REST API. Your platform team can use any open-source SDK 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 SDK

Generated OpenAPI SDKs 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 an SDK

You can use any OpenAPI-compatible code generator. Here are some popular options:
GeneratorLanguagesLink
OpenAPI Generator50+ languages (Java, Go, Ruby, Rust, C#, PHP, etc.)openapi-generator.tech
SpeakeasyPython, TypeScript, Go, Java, C#, Ruby, PHP, Swift, Terraformspeakeasy.com
FernPython, TypeScript, Go, Java, Ruby, C#buildwithfern.com
StainlessPython, TypeScript, Go, Java, Kotlinstainless.com

​
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
The generated SDK 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

ApproachBest For
Generated OpenAPI SDKTeams using languages beyond Python, strict dependency policies, serverless environments, or wanting full control over the client
HoneyHive Tracer SDKPython teams wanting automatic instrumentation with OpenTelemetry, auto-captured LLM calls, and built-in context propagation
TypeScript API ClientTypeScript / Node.js teams wanting a typed REST client for tracing, datasets, and experiments
Direct REST API callsQuick 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 SDK

Type-safe TypeScript client for the HoneyHive REST API.