UUID v4 that identifies the event
OptionalmetadataOptional. Metadata field used by the Langfuse SDKs for debugging.
Datetime (ISO 8601) of event creation in client. Should be as close to actual event creation in client as possible, this timestamp will be used for ordering of events in future release. Resolution: milliseconds (required), microseconds (optimal).
Sunset warning: this is the deprecated Langfuse v3 ingestion API. It is shut down on November 16, 2026, except for score events: from that date it accepts only
score-createevents and rejects all other event types, including this one. To write scores, preferPOST /api/public/scores; see the Scores API docs. To write traces and observations, always prefer upgrading to the current Python and JS SDKs. If you use custom auto-instrumentation, send them to the OpenTelemetry endpoint (POST /api/public/otel/v1/traces), for example with curl; see the OpenTelemetry integration docs. To read data back, use the v4 read APIs; see the Observations API docs and the Metrics API docs. The only path to live data is OpenTelemetry ingestion combined withGET /api/public/v2/observationsandGET /api/public/v2/metrics. All other public APIs may have data delays of several minutes.