Miro REST API and Web SDK 2.0: ⚠ breaking changes! ⚠
Changes to style parameters (REST API); changes to item resizing (Web SDK).

Summary

Miro Web SDK 2.0	Miro REST API 2.0
Resizing board items by updating their `width` and `height` properties has changed. The Miro Web SDK supports more style properties for board items. `app_card:open` fires to all app iFrames.	`style.backgroundOpacity` has been renamed to `style.fillOpacity`. This change affects the `style` object of the shape and text items.

❗️
Breaking changes

Miro Web SDK 2.0 Miro REST API 2.0
Sticky notes: on creation and update, you can only set either width or height.
You cannot set both at the same time. Shape and Text: the backgroundOpacity property of the style object has been renamed to fillOpacity.

What has changed

We introduced a number of changes to improve support for board items, and to make Miro Web SDK and REST API 2.0 functionality more consistent.

Web SDK 2.0 item resizing

The following table lists the changes related to item resizing.
Update your code for the relevant items, where necessary, so that they can keep working as expected.

Item	Miro Web SDK 2.0
App card Card Text	When creating or resizing an app card, a card, or a text item, you can set: `width` `height`is calculated automatically, based on content and zoom level, and it's read-only.	When creating or resizing an app card or a card item, you can set: `width` `height` `width` and `height` at the same time. In this case, `height` sets the maximum height of the item. If the value for `height` is not specified, it is automatically set to `60`. If the content of the item exceeds the specified `height`, the item is collapsed and displayed in a compact view.
Frame Shape	When creating or resizing a frame or a shape item, you can set: `width` `height` `width` and `height` at the same time. ℹ️ Note: If you try to resize a parent frame that results in one or more child items being placed outside the parent frame, the Web SDK throws an error. This is because resizing the parent frame to the dimensions specified breaks the parent-child relationship between the items.	When creating or resizing a frame or a shape item, you can set: `width` `height` `width` and `height` at the same time. ℹ️ Note: If you try to resize a parent frame that results in one or more child items being placed outside the parent frame, the response returns an error. This is because resizing the parent frame to the dimensions specified breaks the parent-child relationship between the items.
Preview	When creating a preview item, you can set: `width` (optional) `height` is calculated automatically to keep the aspect ratio of the original preview. When resizing a preview item, you can update: Either `width` or `height`. This keeps the aspect ratio of the original preview after resizing it.	N/A
Sticky note	⚠ This is a breaking change for sticky note items that use the Miro Web SDK 2.0 ⚠ When creating or resizing a sticky note item, you can set: Either `width` or `height`. You cannot set both at the same time.

Styles

Miro Web SDK 2.0: we added support for additional style properties for board items.
Miro REST API 2.0: we renamed a style property of shape and text items.

Item	Miro Web SDK 2.0	Miro REST API 2.0
Frame	It's now possible to set and to update the fill color of a frame item: `style.fillColor` You can assign it any valid hex color code. The default fill color value is `transparent` (no fill color).	N/A
Shape Text	It's now possible to set and to update the size of the font displaying the text assigned to the `content` property of shape and text items: `style.fontSize` The default font size is `14`dp.	N/A
Shape Text	N/A	⚠ This is a breaking change for shape and text items that use the Miro REST API 2.0 ⚠ The `backgroundOpacity` property of the `style` object has been renamed to `fillOpacity`.

Events

Changes in this section apply only to the Miro Web SDK 2.0.

Item	Miro Web SDK 2.0
App card	The `app_card:open` event to open a modal containing the detail view of an app card now fires to all iFrames (index, panel and modal) of a Miro Web SDK 2.0 app. Previously, the event would be sent only to the main iFrame. The app panel and modal iFrames wouldn't receive it.

Changelog

2022-03-01 changelog

2022-02-01 changelog

2022-01-27 changelog