/
v1 · stable
Reference

OTLP ingest endpoint

The canonical reference for what Inkvo accepts at the ingest boundary.

Endpoints

ProtocolEndpointSignals
OTLP/HTTPhttps://ingest.inkvo.dev/v1/{traces,metrics,logs}traces, metrics, logs
OTLP/gRPCingest.inkvo.dev:4317traces, metrics, logs
Deploy markershttps://ingest.inkvo.dev/v1/deployschange events

Authentication

Every request carries an ingest-scoped key in the authorization header. Keys are environment-bound; a ik_staging_* key cannot write to production.

Limits

  • Max payload: 4 MiB per request (gzip recommended)
  • Rate: soft limit 10k spans/s on Team, burst to 50k
  • Cardinality: 50k active series per service before sampling kicks in
On a 429
Back off using the Retry-After header. Collectors with a retry queue handle this automatically — don't drop spans on the floor.