Skip to main content

Get Trend

POST 

/projects/:project_id/trend

Return metric trend across a set of runs belonging to this project.

Fetches the requested runs, validates they belong to the project, then queries each run's SUT output Parquet (via DuckDB) for per-run statistics on the named metric. Runs are returned in creation-date order regardless of the order in run_ids. Runs that are still in progress or have no Parquet output are silently omitted from the series. Runs where a qualified dimension cannot resolve against that historical dataset version are listed in skipped_run_ids.

Each series point is enriched with created_at and tags from the run record so the UI can render a time axis without a second request.

Returns 422 if run_ids is empty, exceeds MAX_TREND_RUNS, or if group_by is not a valid dimension column in the run output schema. Returns 424 if a qualified dataset dimension's Parquet data is unavailable.

Request​

Responses​

Successful Response