---
updatedAt: 2026-03-19T19:38:45.000Z
agentTools:
  projectIndex: https://developers.miro.com/llms.txt
---

# Rate limiting

When your app makes a call to the Web SDK, the call consumes resources.
Consumption is calculated in credits, and it depends on the type of operation, as well as on the type of board item that is the target of the request.

For example:

* Drag and drop events don't use any credits.
  Cost: 0 credits
* Most calls use 50 credits per call.
* Time-consuming operations such as creating or updating images and embed items are computationally more expensive than getting a sticky note; therefore, they consume more credits.
  Cost: 500 credits per call

Within the enforced rate limits, it's possible to perform bulk actions (creating, updating or deleting multiple items at once).

Web SDK methods fall in one of the following rate limit weight levels:

| Weight                                     | Cost of one Web SDK API call | Action                                      |
| :----------------------------------------- | :--------------------------- | :------------------------------------------ |
| <span class="rate-limit-l1">Level 1</span> | 50 credits                   | Most actions on board items.                |
| <span class="rate-limit-l2">Level 2</span> | 100 credits                  | N/A                                         |
| <span class="rate-limit-l3">Level 3</span> | 500 credits                  | Create or update an image or an embed item. |
| <span class="rate-limit-l4">Level 4</span> | 2000 credits                 | N/A                                         |

Current rate limits for the Miro Web SDK:

| Limit                   | Credits   | Note                                                                                                         |
| :---------------------- | :-------- | :----------------------------------------------------------------------------------------------------------- |
| Max. credits per minute | 100,000   | It supports:<ul><li>Creating 2000 board items a minute.</li><li>Creating 200 image items a minute.</li></ul> |
| Max. credits per hour   | 1,000,000 | It supports:<ul><li>Creating 20000 board items an hour.</li><li>Creating 2000 image items an hour.</li></ul> |

If your app exceeds either limit, it receives an error.
If your app exceeds a limit, it needs to wait for new credits before making calls to the Web SDK.
New credits are issued after the time interval when the limit was triggered has elapsed.

## SDK APIs rate limits

| API                                                                                                     | Cost (credits per call)       |
| :------------------------------------------------------------------------------------------------------ | :---------------------------- |
| [`miro.board.createAppCard`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createappcard)                                  | 50                            |
| [`miro.board.createCard`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createcard)                                        | 50                            |
| [`miro.board.createConnector`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createconnector)                              | 50                            |
| [`miro.board.createEmbed`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createembed)                                      | 500                           |
| [`miro.board.createFrame`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createframe)                                      | 50                            |
| [`miro.board.createImage`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createimage)                                      | 500                           |
| [`miro.board.createPreview`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createpreview)                                  | 50                            |
| [`miro.board.createShape`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createshape)                                      | 50                            |
| [`miro.board.createStickyNote`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createstickynote)                            | 50                            |
| [`miro.board.createTag`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createtag)                                          | 50                            |
| [`miro.board.createText`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#createtext)                                        | 50                            |
| [`miro.board.getIdToken`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getidtoken)                                        | 50                            |
| [`miro.board.getInfo`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getinfo)                                              | 50                            |
| [`miro.board.getUserInfo`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getuserinfo)                                      | 50                            |
| [`miro.board.getOnlineUsers`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getonlineusers)                                | 50                            |
| [`miro.board.getAppData`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getappdata)                                        | 50                            |
| [`miro.board.setAppData`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#setappdata)                                        | 50                            |
| [`miro.board.canUse`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#canuse)                                                | 50                            |
| [`miro.board.goToLink`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#gotolink)                                            | 50                            |
| [`miro.board.getMetadata`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getmetadata)                                      | 50                            |
| [`miro.board.setMetadata`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#setmetadata)                                      | 50                            |
| [`miro.board.bringToFront`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#bringtofront)                                    | 50                            |
| [`miro.board.sendToBack`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#sendtoback)                                        | 50                            |
| [`miro.board.bringInFrontOf`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#bringinfrontof)                                | 50                            |
| [`miro.board.sendBehindOf`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#sendbehindof)                                    | 50                            |
| [`miro.board.get`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#get)                                                      | 500                           |
| [`miro.board.getSelection`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#getselection)                                    | 500                           |
| [`miro.board.select`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#select)                                                | 50                            |
| [`miro.board.deselect`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#deselect)                                            | 50                            |
| [`miro.board.remove`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#remove)                                                | 50                            |
| [`miro.board.group`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#group)                                                  | 50                            |
| [`miro.board.events.broadcast`](https://developers.miro.com/miro-ea/docs/websdk-reference-events#broadcast)                                  | 50                            |
| [`miro.board.viewport.get`](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport#get)                                          | 50                            |
| [`miro.board.viewport.set`](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport#set)                                          | 50                            |
| [`miro.board.viewport.zoomTo`](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport#zoomto)                                    | 50                            |
| [`miro.board.viewport.setZoom`](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport#setzoom)                                  | 50                            |
| [`miro.board.viewport.getZoom`](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport#getzoom)                                  | 50                            |
| [`miro.board.collaboration.startSession`](https://developers.miro.com/miro-ea/docs/websdk-reference-collaboration#startsession)              | 50                            |
| [`miro.board.collaboration.getSessions`](https://developers.miro.com/miro-ea/docs/websdk-reference-collaboration#getsessions)                | 50                            |
| [`session.end`](https://developers.miro.com/miro-ea/docs/websdk-reference-session#end)                                                       | 50                            |
| [`session.invite`](https://developers.miro.com/miro-ea/docs/websdk-reference-session#invite)                                                 | 50                            |
| [`session.join`](https://developers.miro.com/miro-ea/docs/websdk-reference-session#join)                                                     | 50                            |
| [`session.leave`](https://developers.miro.com/miro-ea/docs/websdk-reference-session#leave)                                                   | 50                            |
| [`session.hasJoined`](https://developers.miro.com/miro-ea/docs/websdk-reference-session#hasjoined)                                           | 50                            |
| [`miro.board.collaboration.attention.isFollowing`](https://developers.miro.com/miro-ea/docs/websdk-reference-attention#isfollowing)          | 50                            |
| [`miro.board.collaboration.attention.getFollowedUser`](https://developers.miro.com/miro-ea/docs/websdk-reference-attention#getfolloweduser)  | 50                            |
| [`miro.board.collaboration.attention.follow`](https://developers.miro.com/miro-ea/docs/websdk-reference-attention#follow)                    | 50                            |
| [`miro.board.collaboration.attention.unfollow`](https://developers.miro.com/miro-ea/docs/websdk-reference-attention#unfollow)                | 50                            |
| [`miro.board.findEmptySpace`](https://developers.miro.com/miro-ea/docs/websdk-reference-board#findemptyspace)                                | 50                            |
| [`miro.board.timer.get`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#get)                                                | 50                            |
| [`miro.board.timer.start`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#start)                                            | 50                            |
| [`miro.board.timer.isStarted`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#isstarted)                                    | 50                            |
| [`miro.board.timer.prolong`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#prolong)                                        | 50                            |
| [`miro.board.timer.stop`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#stop)                                              | 50                            |
| [`miro.board.timer.pause`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#pause)                                            | 50                            |
| [`miro.board.timer.resume`](https://developers.miro.com/miro-ea/docs/websdk-reference-timer#resume)                                          | 50                            |
| [`collection.set`](https://developers.miro.com/miro-ea/docs/websdk-reference-collection#set)                                                 | 50                            |
| [`collection.get`](https://developers.miro.com/miro-ea/docs/websdk-reference-collection#get)                                                 | 50                            |
| [`collection.remove`](https://developers.miro.com/miro-ea/docs/websdk-reference-collection#remove)                                           | 50                            |
| [`miro.board.experimental.createMindmapNode`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#createmindmapnode)      | 50 \* (1 + num\_of\_children) |
| [`miro.board.experimental.action.register`](https://developers.miro.com/miro-ea/docs/websdk-reference-custom-action-management#register)     | 50                            |
| [`miro.board.experimental.action.deregister`](https://developers.miro.com/miro-ea/docs/websdk-reference-custom-action-management#deregister) | 50                            |
| [`miro.board.experimental.get`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#get)                                  | 500                           |
| [`miro.board.experimental.getSelection`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#getselection)                | 500                           |
| [`miro.board.experimental.select`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#select)                            | 50                            |
| [`miro.board.experimental.deselect`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#deselect)                        | 50                            |
| [`miro.board.experimental.remove`](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental#remove)                            | 50                            |

## Items methods rate limits

> **Note:** `Item` refers to most of supported item types on a board. See [supported board items](https://developers.miro.com/miro-ea/docs/board-items#supported-board-items) for more details.

| Method                                                                     | Cost (credits per call) |
| :------------------------------------------------------------------------- | :---------------------- |
| [`item.sync`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#sync)                       | 50                      |
| [`embed.sync`](https://developers.miro.com/miro-ea/docs/websdk-reference-embed#sync)                            | 500                     |
| [`image.sync`](https://developers.miro.com/miro-ea/docs/websdk-reference-image#sync)                            | 500                     |
| [`item.goToLink`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#gotolink)               | 50                      |
| [`item.getMetadata`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#getmetadata)         | 50                      |
| [`item.setMetadata`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#setmetadata)         | 50                      |
| [`item.bringToFront`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#bringtofront)       | 50                      |
| [`item.sendToBack`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#sendtoback)           | 50                      |
| [`item.bringInFrontOf`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#bringinfrontof)   | 50                      |
| [`item.sendBehindOf`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#sendbehindof)       | 50                      |
| [`item.getConnectors`](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note#getconnectors)     | 500                     |
| [`mindmapNode.getChildren`](https://developers.miro.com/miro-ea/docs/websdk-reference-mindmap-node#getchildren) | 500                     |
| [`image.getFile`](https://developers.miro.com/miro-ea/docs/websdk-reference-image#getfile)                      | 50                      |
| [`image.getDataUrl`](https://developers.miro.com/miro-ea/docs/websdk-reference-image#getdataurl)                | 50                      |
| [`group.ungroup`](https://developers.miro.com/miro-ea/docs/websdk-reference-group#ungroup)                      | 50                      |
| [`group.getItems`](https://developers.miro.com/miro-ea/docs/websdk-reference-group#getitems)                    | 50                      |

# Sibling pages

* [Interact with boards and items](https://developers.miro.com/miro-ea/docs/websdk-reference-interact-with-boards-and-items.md)
* [Error handling](https://developers.miro.com/miro-ea/docs/websdk-reference-error-handling.md)
* [Board](https://developers.miro.com/miro-ea/docs/websdk-reference-board.md)
* [Card](https://developers.miro.com/miro-ea/docs/websdk-reference-card.md)
* [Board UI](https://developers.miro.com/miro-ea/docs/websdk-reference-ui.md)
* [Viewport](https://developers.miro.com/miro-ea/docs/websdk-reference-viewport.md)
* [Notifications](https://developers.miro.com/miro-ea/docs/websdk-reference-notifications.md)
* [App card](https://developers.miro.com/miro-ea/docs/websdk-reference-app-card.md)
* [Experimental](https://developers.miro.com/miro-ea/docs/websdk-reference-experimental.md)
* [Realtime Events](https://developers.miro.com/miro-ea/docs/websdk-reference-events.md)
* [Tag](https://developers.miro.com/miro-ea/docs/websdk-reference-tag.md)
* [Custom Action Management](https://developers.miro.com/miro-ea/docs/websdk-reference-custom-action-management.md)
* [Shape](https://developers.miro.com/miro-ea/docs/websdk-reference-shape.md)
* [Frame](https://developers.miro.com/miro-ea/docs/websdk-reference-frame.md)
* [Image](https://developers.miro.com/miro-ea/docs/websdk-reference-image.md)
* [Sticky Note](https://developers.miro.com/miro-ea/docs/websdk-reference-sticky-note.md)
* [Shape experimental](https://developers.miro.com/miro-ea/docs/websdk-reference-shape-experimental.md)
* [Embed](https://developers.miro.com/miro-ea/docs/websdk-reference-embed.md)
* [Connector](https://developers.miro.com/miro-ea/docs/websdk-reference-connector.md)
* [Unsupported](https://developers.miro.com/miro-ea/docs/websdk-reference-unsupported.md)
* [Mindmap Node](https://developers.miro.com/miro-ea/docs/websdk-reference-mindmap-node.md)
* [Preview](https://developers.miro.com/miro-ea/docs/websdk-reference-preview.md)
* [Text](https://developers.miro.com/miro-ea/docs/websdk-reference-text.md)
* [Storage collection](https://developers.miro.com/miro-ea/docs/websdk-reference-collection.md)
* [Storage](https://developers.miro.com/miro-ea/docs/websdk-reference-storage.md)
* [Collaboration](https://developers.miro.com/miro-ea/docs/websdk-reference-collaboration.md)
* [Session](https://developers.miro.com/miro-ea/docs/websdk-reference-session.md)
* [Attention](https://developers.miro.com/miro-ea/docs/websdk-reference-attention.md)
* [Group](https://developers.miro.com/miro-ea/docs/websdk-reference-group.md)
* [History](https://developers.miro.com/miro-ea/docs/websdk-reference-history.md)
* [Tools](https://developers.miro.com/miro-ea/docs/websdk-reference-tools.md)