update_element
Idempotent
Update an existing ArchiMate element by ID, modifying its name, description, folder path, or properties.
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 | |||