Skip to main content

Diff Runs

GET 
/runs/diff

Return a row-level diff between two completed runs.

The two runs must belong to the same workspace. Results are joined on the run's identifier column (input_id for text runs, image_id for CV runs), aliased to input_id. Optional filter (row_status, scorer_name, delta_min/delta_max) and sort params narrow and order the result server-side; total and pagination reflect the narrowed set. The default input_id sort keyset-paginates by that identifier; any other sort uses a composite (sort_value, input_id) cursor.

A trace-run pair joins on the occurrence's scope_ref instead, and each row also carries the granularity it describes (partition_type, target_ref, trace_id, parent_id), null for a wide-format pair. Key a SPAN row on (trace_id, target_ref): a span id is unique only within its trace.

An unrecognised query param (e.g. status instead of row_status) is rejected with 400 rather than silently ignored, so a typo cannot quietly widen the result to the full unfiltered set.

Request​

Responses​

Successful Response