Ingest run events

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
      }
    }
  ]
}
'

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

Runs

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

runs

ingest

Ingest run events

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
      }
    }
  ]
}
'

{
  "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

Successful ingestion

The response from the ingestion API.

results

object[]

Show child attributes

Get related runs Get the latest version

Getting Started

Analytics

Audit Logs

Checklists

Datasets v2

Datasets

Evals

Users

Models

Playground Endpoints

Runs

Templates

Test

Views

Ingest run events

Authorizations

Body

Response