---
title: "Langfuse-compatible ``POST /api/public/ingestion`` endpoint."
method: POST
path: "/api/public/ingestion"
tags: ["api"]
---

# Langfuse-compatible \`\`POST /api/public/ingestion\`\` endpoint.

`POST /api/public/ingestion`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/api/public/ingestion`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

Accepts batch events from Langfuse SDK / compatible clients (e.g. Vapi)
and ingests them as traces, observation spans, and scores.

Returns ``207 Multi-Status`` with per-event success/error reporting,
matching the Langfuse ingestion API contract.

## Request body

- LangfuseIngestionRequest
  - `batch` LangfuseIngestionEvent[], required
    - `id` string
    - `type` string, required
    - `body` object, nullable
    - `timestamp` string

## Response `207`

Multi-Status

- LangfuseIngestionResponse
  - `successes` LangfuseIngestionSuccess[], required
    - `id` string, required
    - `status` integer, required
  - `errors` LangfuseIngestionError[], required
    - `id` string, required
    - `status` integer, required
    - `message` string, required

## Other responses

- `403`: Forbidden
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)