---
title: "Ingest traces via OTLP"
method: POST
path: "/otlp/v1/traces"
tags: ["OpenTelemetry"]
---

# Ingest traces via OTLP

`POST /otlp/v1/traces`

Ingest traces via the OTLP/HTTP protobuf protocol.

This endpoint accepts a serialized
`ExportTraceServiceRequest` protobuf. Point any OTLP/HTTP
collector or SDK at `POST /otlp/v1/traces` and spans will flow
into the same ingest stream as the Agenta-native endpoints.

Use this when you already have OTel instrumentation emitting
OTLP. For new integrations that don't need raw OTLP, prefer
`POST /tracing/spans/ingest` — it takes JSON, accepts Agenta's
nested shape directly, and surfaces parse failures immediately.

## Content-Type and size limit

Binary protobuf only (`Content-Type: application/x-protobuf`).
JSON OTLP is not accepted. Requests larger than the configured
batch limit (default 10 MB, see `AGENTA_OTLP_MAX_BATCH_BYTES`) return
`413 Request Entity Too Large`.

## Response

Successful ingest returns `200 OK` with a serialized
`ExportTraceServiceResponse` protobuf. Parse failures on the
request body return `400`; malformed spans return `500`; quota
exhaustion returns `403`. Like the native ingest paths, spans
are queued on a Redis stream and persisted asynchronously — see
[Tracing — Async write
contract](/reference/api-guide/tracing#async-write-contract-202).

## Response `200`

Successful Response

- CollectStatusResponse — OTLP endpoint readiness response.
  - `status` string, required — Readiness string. `ready` means the router is mounted and accepts OTLP ingest.

## Changes

> 359 revisions in range; 44 could not be searched.

- **2025-06-27** `e3e84db47198` — 1 breaking, 4 info
  - removed the success response with the status `200`
  - api operation id `otlp_ingest` removed and replaced with `otlp_v1_traces`
  - api tag `Observability` added
  - api tag `OpenTelemetry` removed
  - …1 more

[Change history](https://skmtc.dev/agenta-ai/apis/agenta-api/changes/otlp/v1/traces/post.md)

---

[API](https://skmtc.dev/agenta-ai/apis/agenta-api.md) · [All operations](https://skmtc.dev/agenta-ai/apis/agenta-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/agenta-ai/agenta-api/revisions/713e4f3b7519/schema)