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 model calls, you would first track a start event with the input data. Once your model call succeeds, you would need to send an end event to the API endpoint with the output data from the model call.

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

POST /v1/runs/ingest

Ingest run events

cURL

curl --request POST \
  --url https://api.lunary.ai/v1/runs/ingest \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "events": [
    {
      "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
      }
    }
  ]
}
'

200

{
  "results": [
    {
      "id": "some-unique-id",
      "success": true
    }
  ]
}

Authorizations

Authorization · string · header · required

Use a project public API key via Authorization: Bearer <key>.

Body

application/json

events · object

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

object

object[]

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