List sections of a dashboard view
dashboards_get_view_sectionsList a sections-type dashboard view’s real section indexes, headings, and card counts, plus its config hash, so you can safely add, update, or remove cards afterward.
Instructions
List the sections of one type: sections view, with real indexes, headings and card counts.
Resolves the view via _load_view (dashboard config or default-
dashboard view path), requires it to be a sections view, and reports
each section's position, a fallback-derived heading (its heading
card, or title), and card count.
Use when: reading current section indexes before calling
dashboards_add_card_to_section / dashboards_update_card_in_section
/ dashboards_remove_card_from_section, or before re-sending
expected_config_hash to one of them after their previous call
changed it.
Returns: {status, url_path, view_index, view_title, view_path, sections: [{section_index, heading, card_count}, ...], config_hash} —
pass config_hash back as expected_config_hash to
dashboards_add_card_to_section / _update_card_in_section /
_remove_card_from_section / _add_section_to_view to detect a
dashboard change before your write lands.
Errors: raises ValueError when the view can't be resolved (bad
index/path) or is not a type: sections view.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url_path | No | Dashboard url_path (e.g. 'map') or a view path in the default dashboard (e.g. 'living-room'). Omit for the default dashboard's first view. | |
| view_index | No | Zero-based view index; required when url_path names a dashboard rather than a view path. Omit when url_path already identifies the view. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||