POST one standard OpenLineage event and receive a durable delivery receipt.
POST /api/v1/lineage| Name | Required | Description |
|---|---|---|
workspace_id | With unscoped tokens | Target workspace. Optional when the bearer token is workspace-scoped; an explicit value must match the token's workspace. |
connector_id | No | Immutable connector scope for dataset resolution. |
provider_key | No | Stable provider identifier, up to 500 characters. |
Requests with neither a workspace_id parameter nor a workspace-scoped token fail with openlineage_workspace_required. Idempotency-Key is optional, 1 to 600 characters. The body must be one JSON object and no larger than 8 MiB. Compressed bodies are rejected.
curl --request POST \
--url "https://api.embrasure.ai/api/v1/lineage?workspace_id=workspace-1&connector_id=connector-1" \
--header "Authorization: Bearer $EMBRASURE_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: run-0190-complete" \
--data-binary @openlineage-event.json{
"delivery_id": "c5ecf66d-1ca4-4e86-ae60-51c9108490cf",
"state": "accepted",
"duplicate": false,
"item_count": 1,
"invalid_item_count": 0
}The 202 receipt confirms durable acceptance for asynchronous processing. Read ingest lineage for identity and retry behavior.