update_element
Idempotent
Modify an existing ArchiMate element's name, description, folder path, or properties. Properties are merged with existing ones, and the element type cannot be changed.
Instructions
Update an existing ArchiMate element.
Updates is a dict containing only the fields to change. Other fields
are left untouched. Properties are merged into existing properties
(use an empty value to clear a key on subsequent updates).
Args:
element_id: ID of the element to update.
updates: Mapping of fields to update. Supported keys:
- `name` (str): New element name.
- `description` (str): New documentation text.
- `folder_path` (str): New folder path; folder root must
match the element's ArchiMate category.
- `properties` (dict[str, str]): Property updates merged
into existing properties.
Element type cannot be changed; recreate the element to
change its type.
Returns:
Success envelope with the updated `ElementDetail` in `data`.
Errors:
`ElementNotFoundError` when `element_id` is unknown.
`ModelOperationError` for invalid folder paths.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| updates | Yes | ||
| element_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||