Skip to content
UPG is in early alpha. The specification is still evolving and may change between versions.
Tools/Areas & Change Log/update_area

update_area

Edit a product area in `.upg/portfolio.upg` (title, description, strategic_priority, owner) and/or re-parent it via `parent_area_id`. The mirror of `update_product` for the organisational axis. `parent_area_id` is tri-state: omit to leave unchanged, pass null to un-nest (top-level), or pass an area id to re-parent (rejected if it would create a cycle).

Areas & Change Logatomic (single portfolio.upg flush).

Arguments

area_idstringrequired

Product area id to edit (from list_product_areas)

titlestringoptional

New area title

descriptionstringoptional

New area description

strategic_prioritystringoptional

Strategic priority (canonical Priority scale)

urgenthighmediumlownone
parent_area_idstringnulloptional

Re-parent under this area id; null un-nests (top-level); omit to leave unchanged

ownerstringoptional

Person or team that owns this area

Returns

Shape
{ message, area, updated: string[] }

See Also