Langfuse JS/TS SDKs
    Preparing search index...

    Interface IngestionRequest

    {
     *         batch: [{
     *                 type: "trace-create",
     *                 id: "abcdef-1234-5678-90ab",
     *                 timestamp: "2022-01-01T00:00:00.000Z",
     *                 body: {
     *                     id: "abcdef-1234-5678-90ab",
     *                     timestamp: "2022-01-01T00:00:00.000Z",
     *                     environment: "production",
     *                     name: "My Trace",
     *                     userId: "1234-5678-90ab-cdef",
     *                     input: "My input",
     *                     output: "My output",
     *                     sessionId: "1234-5678-90ab-cdef",
     *                     release: "1.0.0",
     *                     version: "1.0.0",
     *                     metadata: "My metadata",
     *                     tags: ["tag1", "tag2"],
     *                     "public": true
     *                 }
     *             }]
     *     }

    {
     *         batch: [{
     *                 type: "span-create",
     *                 id: "abcdef-1234-5678-90ab",
     *                 timestamp: "2022-01-01T00:00:00.000Z",
     *                 body: {
     *                     id: "abcdef-1234-5678-90ab",
     *                     traceId: "1234-5678-90ab-cdef",
     *                     startTime: "2022-01-01T00:00:00.000Z",
     *                     environment: "test"
     *                 }
     *             }]
     *     }

    {
     *         batch: [{
     *                 type: "score-create",
     *                 id: "abcdef-1234-5678-90ab",
     *                 timestamp: "2022-01-01T00:00:00.000Z",
     *                 body: {
     *                     id: "abcdef-1234-5678-90ab",
     *                     traceId: "1234-5678-90ab-cdef",
     *                     name: "My Score",
     *                     value: 0.9,
     *                     environment: "default"
     *                 }
     *             }]
     *     }
    interface IngestionRequest {
        batch: IngestionEvent[];
        metadata?: unknown;
    }
    Index

    Properties

    batch metadata?

    Properties

    batch: IngestionEvent[]

    Batch of events to be ingested, discriminated by attribute type. From November 16, 2026 on Langfuse Cloud, only score-create events are accepted; all other event types are rejected.

    metadata?: unknown

    Optional. Metadata field used by the Langfuse SDKs for debugging.

    Settings

    Member Visibility

    On This Page

    Properties