The platform API now supports boards with multiple levels of subitems and rollup columns that summarize values across child items. This guide provides a detailed explanation of the functionality and how to adapt your queries

Initially, only project boards within the Portfolio solution will support this board layout.

Related API schema changes

• boards: added hierarchy_type field
• boards: added hierarchy_types filter argument
• columns: added capabilities field
• create_column: now accepts a capabilities argument
• update_column: now accepts a capabilities argument
• Status rollups: new BatteryValue fragment when reading rollup values
• items_page: added hierarchy_scope_config argument
• items_page_by_column_values: added hierarchy_scope_config argument

Backwards compatibility

No breaking changes. Until 2026-04, boards returns only classic boards by default. Use the hierarchy_types argument to include multi-level boards.

Other changes

The behavior of some endpoints depends on the board type (e.g., on multi-level boards, rollup columns on parent items are read-only when subitems exist). See the full guide for details.