Ingest run events

This endpoint is for reporting data from platforms not supported by our SDKs.

You can use either your project’s Public or Private Key as the Bearer token in the Authorization header.

The expected body is an array of Event objects.

For LLM calls, you would first track a start event with the input data. Once your LLM call succeeds, you would need to send an end event to the API endpoint with the output data from the LLM call.

For a full step-by-step guide on sending LLM data to the Lunary API, see the Custom Integration guide.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

events

Represents an event in the Lunary API for tracking LLM calls and related operations.

Show child attributes

Example:

{
  "type": "llm",
  "event": "start",
  "runId": "some-unique-id",
  "name": "gpt-4",
  "timestamp": "2022-01-01T00:00:00Z",
  "input": [
    { "role": "user", "content": "Hello world!" }
  ],
  "tags": ["tag1"],
  "extra": { "temperature": 0.5, "max_tokens": 100 }
}

Response

200

application/json

Successful ingestion

The response from the ingestion API.

results · object[]

Show child attributes