POST a rendered SQLMesh project export as a partial or complete declared-lineage acquisition.
POST /v1/pipelines/sqlmesh/project| Body field | Required | Description |
|---|---|---|
workspace_id | Yes | Target workspace. |
connector_id | Yes | Connector scope for relation resolution. |
project | Yes | An embrasure.sqlmesh-project@v1 export, including its SQLMesh environment. |
project_id | No | Stable identifier for the SQLMesh project. Required for complete. |
completeness | No | partial or complete; default partial. |
source_event_key | No | Body alternative to Idempotency-Key. |
curl --request POST https://api.embrasure.ai/v1/pipelines/sqlmesh/project \
--header "Authorization: Bearer $EMBRASURE_API_TOKEN" \
--header "Content-Type: application/json" \
--header "Idempotency-Key: sqlmesh-build-842" \
--data-binary @/tmp/embrasure-sqlmesh-request.jsonThe request file wraps the exporter output with the fields above, as shown in pipelines and applications. The route returns 202. A complete acquisition needs an exact connector, project, and SQLMesh environment scope plus a caller-supplied idempotency key. A complete prod export never retracts dev lineage. Embrasure rejects a complete snapshot when export-shape errors would make retraction lossy. If the header and source_event_key are both present, they must match.
| Situation | Result |
|---|---|
| SQL model with rendered SQL | Parsed only when every read matches a declared dependency. |
| Python model | Table dependencies remain; columns report non_sql_model. |
| No rendered SQL | Table dependencies remain; columns report rendered_sql_unavailable. |
| Rendered SQL reads an undeclared relation | No mapping is guessed; columns report rendered_sql_reads_outside_declared_dependencies. |
| Embedded dependency | No relation is emitted; model metadata reports embedded_dependency_has_no_relation. |
| External model or seed | Accepted as a dependency target without producing its own declared observation. |
| SQL parser limitation | The parser's unresolved_reason is preserved. |