---
title: "Ingest OpenLineage event"
method: POST
path: "/api/v1/lineage"
tags: ["lineage"]
---

# Ingest OpenLineage event

`POST /api/v1/lineage`

Process OpenLineage run events and update assets/lineage accordingly

## Request body

- RunEvent
  - `eventTime` string
  - `eventType` string
  - `inputs` Dataset[]
    - `facets` object
    - `inputFacets` object
    - `name` string
    - `namespace` string
    - `outputFacets` object
  - `job` Job
    - `facets` object
    - `name` string
    - `namespace` string
  - `outputs` Dataset[]
    - `facets` object
    - `inputFacets` object
    - `name` string
    - `namespace` string
    - `outputFacets` object
  - `producer` string
  - `run` LineageRun
    - `facets` object
    - `runId` string
  - `schemaURL` string

## Response `200`

Event processed successfully

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

> 56 revisions in range; 1 not diffed.

- **2026-08-24** `0bd802afff21` — 2 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - the endpoint scheme security `BearerAuth` was added to the API
- **2026-08-20** `cadebfd78fef` — 1 breaking
  - api path removed without deprecation
- **2025-08-13** `231a3bc352fa` — 1 info
  - endpoint added
- **2025-06-02** `0c070796939d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/marmotdata/apis/marmot-api/changes/api/v1/lineage/post.md)

---

[API](https://skmtc.dev/marmotdata/apis/marmot-api.md) · [All operations](https://skmtc.dev/marmotdata/apis/marmot-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/marmotdata/marmot-api/revisions/0bd802afff21/schema)