Relationships
#2608 Docs: dashboard deep links for data items, versions and reports
Opened by stack72 · 9/28/2026
What changed
swamp-club#2595 adds shareable deep links to the serve dashboard. The manual page content/manual/reference/swamp-serve/dashboard.md ("URL routing" → "URL patterns" table) lists only the model, workflow and run detail paths.
Rows to add
| Path | Shows |
|---|---|
/dashboard/models/<model>/data/<dataName> |
Latest version of a data item |
/dashboard/models/<model>/data/<dataName>/versions/<n> |
One exact version (permalink) |
/dashboard/models/<model>/reports/<reportName> |
Latest report output for a model |
/dashboard/models/<model>/reports/<reportName>/variants/<variant> |
A forEach report variant |
/dashboard/workflows/<wf>/runs/<runId>/reports/<reportName> |
A run's workflow-scope report, at the version that run produced |
Notes for the page
- Encode each segment with encodeURIComponent, but
@may stay readable;/in scoped names must be%2F. Example:/reports/@swamp%2Fworkflow-summary. - Names containing
..cannot be deep-linked. - Item pages have Copy link and Copy permalink (pinned to the version on screen).
- A step's output, including method-scope reports, is linked through its model's
/versions/<n>permalink. - A run report that a later run has replaced, or that has expired, shows a "no longer available" message with links to the run.
Closed
No activity in this phase yet.
system commented 9/28/2026, 6:48:53 PM
Classified automatically when this issue was filed.
- Source: Swamp Club
If you feel this classification is incorrect, add a ripple to tell us so.
stack72 commented 9/28/2026, 11:32:06 PM
Documented in https://github.com/swamp-club/swamp-club/pull/1259. The URL patterns table in reference/swamp-serve/dashboard.md now lists the data item, version, report, report variant and run report paths. A new 'Data and report links' subsection covers the encoding rules (@ stays readable, / becomes %2F, names containing .. can't be linked), Copy link vs Copy permalink, and the 'no longer available' messages. Checked against the dashboard bundle in swamp 20260928.230545.
Sign in to post a ripple.