update_canonical_entity
Edit a canonical registry entity in place (title, description, audience_role, tags, properties) WITHOUT disturbing the `instance_of` edges that point at it. The fix for a canonical seeded with a typo or placeholder: correct it via the API instead of hand-editing portfolio.upg. Properties are shallow-merged. At least one editable field is required.
Workspace & Portfoliosnon-atomic. In-place registry node patch + flush.
Arguments
canonical_idstringrequiredThe registry entity id (bare, or registry/{id}).
titlestringoptionalNew canonical name.
descriptionstringoptionalNew description.
audience_rolestringoptionalPersona audience role (buyer/user/champion/influencer/partner); merged into properties.
tagsarrayoptionalReplacement tags.
propertiesobjectoptionalProperties to shallow-merge into the canonical.
Returns
Shape
{ canonical, qualified_id, instance_count, portfolio_file }