Inspect the release manifest
GET /v1/datasets/{dataset_id}/releases/{release_id}Require matching dataset_id, the expected schema_version, and immutable=true. Record dataset_version and definition_version so downstream incidents can be traced to both data and definition changes.
Gate explicitly on quality
| quality_status | Meaning | Recommended default |
|---|---|---|
| complete | Configured source coverage and validation completed for the release | Accept |
| partial | Coverage or validation is incomplete | Quarantine unless the use case explicitly permits partial data |
Preserve parent lineage
parent_release_id links a release to its predecessor when available. Use it to explain deltas, detect a broken chain, and show which release an import replaced. A null parent identifies a root or a release without declared parent lineage.
Choose a release policy
| Policy | Use when | Trade-off |
|---|---|---|
| Pinned release ID | Reproducibility is mandatory | Requires an explicit upgrade |
| Latest complete | Freshness matters and partial data is unacceptable | Results change when a new complete release appears |
| Latest including partial | Coverage gaps are acceptable and visible | Every consumer must handle partial data |