Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Helicone Trace API

The Trace API from Helicone — 5 operation(s) for trace.

Helicone Trace API is one of 33 APIs that Helicone publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Trace. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, pricing, an API reference, and an engineering blog.

This API exposes 5 operations across 5 paths, and defines 12 schemas. It is described by OpenAPI 3.0.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.helicone.ai/, http://localhost:8585/.

5 operations 5 paths 12 schemas 5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
1.0.0
Base URL
https://ai-gateway.helicone.ai
Authentication
API Key
License
MIT
Resource Areas
1

Authentication & Security 1

Helicone Trace API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (api_key).

  • api_key — Bearer token authentication. Format: 'Bearer YOURAPIKEY'

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 POST. Each is listed below with its method, path, parameters, and response codes.

Trace 5
POST
/v1/trace/custom/v1/log
LogCustomTraceLegacy body → 204
POST
/v1/trace/custom/log
LogCustomTrace body → 204
POST
/v1/trace/custom/log/typed
LogCustomTraceTyped body → 200
POST
/v1/trace/log
LogTrace body → 204
POST
/v1/trace/log-python
LogPythonTrace body → 204

Schemas 12

The contract defines 12 schemas that model the data the API accepts and returns. The most detailed are TypedAsyncLogModel (4 properties), TypedProviderResponse (4 properties), TypedTiming (3 properties), TypedProviderRequest (3 properties). Each schema is shown below with its type and property counts.

TypedAsyncLogModel
object
4 properties 2 required
ProviderName
string
ValidationError
object
2 properties 2 required
OTELTrace
object
1 property 1 required
Provider
TypedTiming
object
3 properties 2 required
TypedProviderRequest
object
3 properties 3 required
ValidationResult
object
2 properties 2 required
Record_string.unknown_
object
Construct a type with a set of properties K of type T
TypedProviderResponse
object
4 properties 2 required
ModelProviderName
string
Record_string.string_
object
Construct a type with a set of properties K of type T

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

helicone-trace-api-openapi.yml Raw ↑

Other APIs Helicone publishes across the network.

Helicone Agent API
Helicone API Key API
Helicone Comparison API
Helicone Credits API
Helicone Customer API
Helicone Dashboard API
Helicone Dataset API
Helicone Evals API
Helicone Evaluator API
Helicone Experiment API
Helicone HeliconeSql API
Helicone Integration API