Skip to main content

Promote Trace Version Endpoint

POST 
/traces/versions/:version_id:promote

Choose which version of a trace dataset its metrics score, stepping back whichever was.

The trace-scoped counterpart to /datasets/{id}/versions/{vid}/promote, which rejects trace schemas: it touches this dataset only — never a sibling that landing made current independently — and runs no quality gate, since no quality check accepts agent_trace_v1.

Attaching ground truth already hands currency to the version it derives, so this exists for the cases that are not that: going back to the un-annotated version, or selecting a derivation that was built from a version which was not current at the time.

Returns 404 if the version does not exist or belongs to a workspace the caller is not a member of, and 403 if the caller is a member without editor-level access. Returns 422 if the version is already current, or does not belong to a trace dataset.

Request​

Responses​

Successful Response