Skip to main content

update_item_property

Sets one property of an item to a new value, using the friendly REST property names — e.g. text, fontSize, fillColor, strokeColor, angle, or position = {x,y} / size = {width,height}. The item type is resolved automatically; pass itemType to skip the lookup.

Tool name: update_item_property

Parameters

ParameterTypeRequiredDefaultDescription
projectIdstringYesTarget project (map) id.
itemIdstringYesId of the item to update.
propertyNamestringYesProperty name, e.g. "text", "fillColor", "angle".
valueanyYesNew value — string, number, boolean, or object as appropriate.
itemTypestringNoAuto-resolvedOne of label, sticky-note, shape, connector, image, web, svg, document.

Common Properties

PropertyValue shapeApplies to
textstring (plain text or HTML)labels, stickies
fontSizenumber ≥ 1labels, stickies
fillColorCSS color stringshapes
strokeColorCSS color stringshapes, connectors
strokeThicknessnumber ≥ 0shapes, connectors
position{ "x": number, "y": number }all items
size{ "width": number, "height": number }all items
anglenumber (degrees, 0–360)all items

The full per-type field reference is available via get_data_model.

Returns

{ "updated": true, "itemId": "11aa22bb-...", "propertyName": "text" }

Example

"Rotate the hexagon by 45 degrees."

{
"projectId": "a1b2c3d4-...",
"itemId": "77gg88hh-...",
"propertyName": "angle",
"value": 45
}

For color and font changes, style_item is usually more convenient — it maps fields to the right property per item type automatically.