Insights build link
insights_build_linkBuild a clickable Insights dashboard URL for a specific set of TestRail run IDs (optionally filtered by status). USE THIS when the user asks to view / open / show / explore test run data and you have concrete run IDs in mind (resolve names → IDs first via testrail_list_runs if needed). The returned URL is a relative path on this app — present it as a markdown link, e.g. [View dashboard](/insights?runs=47,103&status=failed). The tool validates every run ID exists via the caller's TestRail credential; a run the caller cannot read is reported as missing and the tool refuses to emit a URL containing only missing runs (clicking it would land on an empty dashboard, which reads as "agent gave me garbage"). This tool returns NO numbers. To answer with counts or pass rates call insights_testrail_summary (its result already carries a dashboard_url); use this tool when you want a status filter on the link or to confirm run IDs exist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| runs | Yes | TestRail run IDs to include in the dashboard view. At least 1, up to 10. Single-run mode renders one dashboard; multi-run mode combines them. Use `testrail_list_runs` first if you don't know the IDs. | |
| status | No | Optional status filter applied to the dashboard. One of: passed | failed | blocked | retest | untested. Omit to show all statuses. |