Skip to content

Get for run lineage

GET /api/v1/lineage/for-run/{runId}: request fields and declared response contract.

GET/api/v1/lineage/for-run/{runId}

Authorization
PermissiondataPipelines.read
Workspace scoperequired
Scope targetworkspace

Parameters

Path parameters
FieldTypeRequiredNullableDefault
runIdstringrequirednon-null—
Query parameters
FieldTypeRequiredNullableDefault
direction"ancestors" | "descendants" | "both"optionalnon-null—
depthintegeroptionalnon-null—
limitintegeroptionalnon-null—
cursorstringoptionalnon-null—

Response

200

Response fields
FieldTypeRequiredNullableDefault
dataobjectrequirednon-null—
data.nodesarrayrequirednon-null—
data.edgesarrayrequirednon-null—
data.truncatedbooleanrequirednon-null—
data.redactionsintegerrequirednon-null—
data.unsupportedKindsarrayrequirednon-null—
data.warningsarrayrequirednon-null—
data.resolverFailuresintegeroptionalnon-null—
data.nextCursorstringoptionalnon-null—

Declared failures

Declared failures
LINEAGE_READ_FAILED500 — not retryable

Readback

This method returns the current state it read.

  • lineage.getForRun

Request example

Schematic only. Replace placeholders with real values and include all required nested fields.

GET /api/v1/lineage/for-run/{runId} HTTP/1.1
Authorization: Bearer <token>
x-merulan-workspace-id: <workspace-id>