Skip to main content

Promote Version To Golden

POST 
/datasets/:dataset_id/versions/:version_id/promote

Promote a dataset version to golden.

Copies the version's Parquet (which should already have column mapping applied via /map) to the canonical golden path, marks DatasetVersion.is_golden = True, sets stage="golden", and transitions the parent Dataset.status to active if still pending.

The latest quality verdict must be PASS, or WARN with force=true in the body — an audited override acknowledging the warnings. FAIL, STALE, NOT_RUN, and dimension-source integrity failures reject regardless of force. Versions in any stage (raw, mapped, augmented) can be promoted when the gate allows — if a raw version is promoted, no column renaming will have been applied.

Rejects agent_trace_v1, which manages its own version lifecycle.

Request​

Responses​

Successful Response