get_dashboard
Read back one of your published dashboard files by path. Parameters, the base64 return shape, errors and workspace membership rules.
Downloads one previously-published file by its <slug>/<filename> path. The
handle is added server-side. The body comes back base64-encoded; decode it before
displaying.
Behaviour hints for clients: read-only, not open-world.
Parameters
| Parameter | Type | Required | Notes |
|---|---|---|---|
path | string | yes | <slug> or <slug>/<filename>. A bare slug means <slug>/index.html. |
There is no workspace argument. A workspace-authorized connection reads that
workspace's dashboards; a personal one reads yours.
Returns
Retrieved.
Path: mickey/revenue-overview/index.html
Content-Type: text/html
Bytes: 48213
Body (base64): PCFET0NUWVBFIGh0bWw+...
Errors
The shared path rules, plus:
| Condition | Text |
|---|---|
| Membership recheck failed in transport | Could not verify workspace access: <err> |
| Not found, personal | 404 not found: "<slug>/<file>" under <handle> |
| Not found, workspace | 404 not found: "<slug>/<file>" under the <workspace> workspace |
The membership recheck fails closed: a transport failure refuses the read rather than falling through to it.
Scope
Workspace-capable, with one extra safeguard. This tool reads storage directly
from the authorization's lock, so it re-verifies workspace membership on every
call rather than trusting the lock. Someone removed from a workspace gets the
same 404 as a missing file, so the refusal is not an existence oracle.
Check it worked
Decode the returned body and compare its byte count against the Bytes: line. A
mismatch means the base64 was truncated somewhere in your client, not in the
response.