Data Lineage

List lineage events

get

Retrieves all lineage events for the current user

Responses

200

Lineage events retrieved

application/json

List of lineage events for the current user

graph_datastring · nullableOptional

Serialized graph data

graph_hashstringRequired

Unique hash of the graph

graph_idinteger · nullableOptional

Associated graph ID

inserted_atstring · date-timeRequired

Creation timestamp

messagestring · nullableOptional

Additional message

statusstring · enumRequired

Current status of the lineage event

Possible values:

task_referencestring · nullableOptional

Reference to the background task

typestring · nullableOptional

Type of lineage event

user_idintegerRequired

User who created the event

401

Unauthorized

application/json

403

Forbidden

application/json

500

Internal Server Error

application/json

get/api/lineage_events

HTTPcURLJavaScriptPython

GET /api/lineage_events HTTP/1.1
Accept: */*

[
  {
    "graph_data": "[\"bar\"]",
    "graph_hash": "abc123def456",
    "graph_id": null,
    "inserted_at": "2026-05-08T10:00:00Z",
    "message": null,
    "status": "COMPLETED",
    "task_reference": "0.0.1234...",
    "type": null,
    "user_id": 123
  }
]

Export graph as CSV

post

Exports a graph's data as a ZIP archive containing CSV files.

Body

application/json

idany ofRequired

Graph ID to export as CSV (string or integer)

stringOptional

or

integerOptional

Responses

200

CSV file downloaded

text/csv

string · binaryOptional

401

Unauthorized

application/json

404

Not found

application/json

500

Internal Server Error

application/json

post/api/graphs/csv

HTTPcURLJavaScriptPython

POST /api/graphs/csv HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "id": "graph-123"
}

binary

Create graph

post

Creates a new graph for lineage or impact analysis.

• type: "sample" → no requiere ids

• type: "lineage" o "impact" → requiere ids

Body

application/json

header_labelsboolean · nullableOptional

Include header labels in the response

levelsinteger · nullableOptional

Number of levels to traverse

typestring · enumRequired

Type of graph to generate

Possible values:

Responses

201

Graph created

application/json

Response for graph creation. Can be completed (201) or processing (202)

or

202

Graph processing

application/json

401

Unauthorized

application/json

422

Unprocessable Entity

application/json

500

Internal Server Error

application/json

post/api/graphs

HTTPcURLJavaScriptPython

POST /api/graphs HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 85

{
  "excludes": null,
  "header_labels": true,
  "ids": [
    "bar",
    "baz"
  ],
  "levels": 2,
  "type": "impact"
}

{
  "excludes": [],
  "groups": [
    {
      "id": "@@ROOT"
    },
    {
      "id": "foo"
    }
  ],
  "id": "graph-123",
  "ids": [
    "bar"
  ],
  "opts": {
    "type": "impact"
  },
  "paths": [
    {
      "path": [],
      "v1": "bar",
      "v2": "baz"
    }
  ],
  "resources": [
    {
      "id": "bar"
    },
    {
      "id": "baz"
    }
  ]
}

Get graph

get

Retrieves a graph by its ID, automatically recalculating it if it is stale.

Path parameters

idstringRequired

Graph ID

Responses

200

Graph retrieved

application/json

401

Unauthorized

application/json

404

Not found

application/json

500

Internal Server Error

application/json

get/api/graphs/{id}

HTTPcURLJavaScriptPython

GET /api/graphs/{id} HTTP/1.1
Accept: */*

{
  "data": {
    "excludes": [],
    "groups": [
      {
        "id": "@@ROOT"
      },
      {
        "id": "foo"
      }
    ],
    "id": "graph-123",
    "ids": [
      "bar"
    ],
    "opts": {
      "type": "impact"
    },
    "paths": [
      {
        "path": [],
        "v1": "bar",
        "v2": "baz"
      }
    ],
    "resources": [
      {
        "id": "bar"
      },
      {
        "id": "baz"
      }
    ]
  }
}

Get graph by hash

get

Retrieves a graph by its hash value, returning its current data or processing status.

Path parameters

hashstringRequired

Graph hash

Responses

200

Graph retrieved

application/json

Response for graph retrieval by hash. Can be completed (200) or processing (202)

or

202

Graph processing

application/json

401

Unauthorized

application/json

404

Not found

application/json

500

Internal Server Error

application/json

get/api/graphs/hash/{hash}

HTTPcURLJavaScriptPython

GET /api/graphs/hash/{hash} HTTP/1.1
Accept: */*

{
  "excludes": [],
  "groups": [
    {
      "id": "@@ROOT"
    },
    {
      "id": "foo"
    }
  ],
  "hash": "abc123def456",
  "id": "graph-123",
  "ids": [
    "bar"
  ],
  "opts": {
    "type": "impact"
  },
  "paths": [
    {
      "path": [],
      "v1": "bar",
      "v2": "baz"
    }
  ],
  "resources": [
    {
      "id": "bar"
    },
    {
      "id": "baz"
    }
  ]
}