Skip to main content

Get Ground Truth

GET 
/traces/versions/:version_id/ground-truth

Return the ground truth a version carries — 'which columns, and what values, per identifier'.

Answers the "is it there, and is it right" question for a derived version. Bounded by limit/offset for the same reason as the drop rows: a dataset can annotate many sessions. columns and row_count always describe the whole artifact, not the returned page, so a caller checking metric availability never has to page to learn which columns exist.

The paging bounds the RESPONSE, not the read — the artifact is one row per session and is decoded whole. The upload's own size limit is what keeps that bounded; a caller that only wants the column names should read them off the version instead (ground_truth_columns), which touches no object at all.

A version with no ground truth attached returns empty columns and rows rather than a 404 — that is the answer for every freshly landed version, not a missing resource.

Returns 404 only if the version itself does not exist or belongs to a workspace the caller is not a member of.

Request​

Responses​

Successful Response