list_dashboards

Enumerate your dashboards newest-updated first, with cursor pagination. Parameters, return shape, the degraded folder state and scope.

Lists your active dashboards, most-recently-updated first. Soft-deleted dashboards are excluded. Pagination is cursor-based over (updated_at DESC, dashboard_id DESC).

Behaviour hints for clients: read-only, not open-world.

Parameters

Parameter	Type	Required	Notes
`limit`	integer	no	Page size, minimum 1, maximum 100. Default 50.
`cursor`	string	no	Opaque cursor from a prior response's `next_cursor`. Omit on the first call.

Treat the cursor as opaque. Its format may change.

Returns

2 dashboards for mickey (more available - pass next_cursor to paginate).

• revenue-overview - Revenue Overview
  URL: https://mickey.dashies.xyz/revenue-overview
  Visibility: public · Updated: 2026-07-30T14:00:03Z · Chart: bar · Folder: Sales / Q4
  Tags: revenue, board

• churn-2026 - Churn 2026
  URL: https://mickey.dashies.xyz/churn-2026
  Visibility: private · Updated: 2026-07-28T09:11:00Z

Next cursor: eyJ1cGRhdGVkX2F0Ijoi...

BEGIN_JSON
{"user_handle":"mickey","count":2,"has_more":true,"next_cursor":"eyJ1...","folder_path_degraded":false,"dashboards":[]}
END_JSON

Empty and continuation states:

State	Text
No dashboards at all	`No active dashboards for <label>.`
A cursor page past the end	`No more dashboards after cursor.`
A non-first page	`<n> dashboards for <label> (continuation page)`

Two different meanings of no folder

If the folder tree cannot be fetched, the prose adds (Folder context unavailable for this response - dashboards may still be organised; retry to see folders.) and the JSON sets folder_path_degraded: true. That is not the same as a dashboard having no folder, and the flag is how you tell them apart.

Errors

Condition	Text
The read failed	`list failed: <msg>`
The read returned the wrong shape	`list failed: db returned non-array`
A cursor that cannot be decoded	A cursor-decode refusal naming the bad value

Scope

Workspace-capable. A workspace-authorized connection lists that workspace's dashboards at <workspace>.dashies.xyz/<slug>. On the workspace branch folder_path is always null, because folders are a personal-space feature.

Check it worked

Compare count against the number of bullets. If has_more is true, pass next_cursor back and confirm the second page opens with the continuation header rather than repeating the first page.