Introduction

Our APIs are based on a RESTful approach (see REST). It features predictable and resource-oriented URLs and uses HTTP response codes to indicate API errors. Our REST APIs comprise of HTTP methods that you can use to build integrations that don't rely on interactions in the Miro interface.

Why you should use our REST APIs:

Connect a Miro board to a third-party product
Enable flows that require communicating with a server backend or a database
Enable a service to exchange data programmatically using languages other than Javascript or Typescript

Rate limiting

Your app's requests to the REST API are evaluated per method. Currently, there is a limit of 100,000 credits for API calls per minute. Each REST API method is assigned one of the rate limit weight levels.

Rate limiting is applied on a per user per application basis.

Weight	Cost of one API call	Requests per minute
Level 1	50 credits	2000
Level 2	100 credits	1000
Level 3	500 credits	200
Level 4	2000 credits	50

If the number of requests exceeds the limit, a standard 429 Too many requests error is returned:

{
  "status": 429,
  "code": "tooManyRequests",
  "message": "Request rate limit exceed",
  "context": null,
  "type": "error"
}

The following HTTP headers are included in every response, allowing you to check your current limitations:

Header name	Description
`X-RateLimit-Limit`	Total credits that can be allocated per minute
`X-RateLimit-Remaining`	Number of credits left for the time window
`X-RateLimit-Reset`	Timestamp (UNIX epoch) for when the credits will be reset

Enterprise plan

Certain APIs are only available on the Enterprise plan. You can access Enterprise APIs only if you have the Company Admin role. The goal of providing these additional capabilities for Enterprise plan users is to enable a consistent and secure user experience while creating your custom solutions. Additionally, to install applications that use the Enterprise APIs, you must have a team with an Enterprise plan. For example, the Teams API provides the capability to manage teams in your organization. As Miro Teams at scale are only available within the Enterprise plan, the scope of the Teams API is also limited to the Enterprise plan only.

📘
You can request a temporary access to enterprise APIs by filling out this request form.

For more information on various plans and the feature matrix, see the Miro pricing plan page.

Access Enterprise APIs

Learn how to access Miro's Enterprise APIs.

What can I do with the REST API?

The REST API supports the following CRUD operations on boards, board members, and supported board items:

Board item	Create	Read	Update	Delete
App card	✅	✅	✅	✅
Board	✅	✅	✅	✅
Board member	✅	✅	✅	✅
Card	✅	✅	✅	✅
Connector	✅	✅	✅	✅
Comment	❌	❌	❌	❌
Document	✅	✅	✅	✅
Embed	✅	✅	✅	✅
Emoji	❌	❌	❌	✅
Frame	✅	✅	✅	✅
Image	✅	✅	✅	✅
Kanban	❌	❌	❌	❌
Mindmap	❌	❌	❌	❌
Organization (Enterprise plan only)	❌	✅	❌	❌
Organization member (Enterprise plan only)	❌	✅	❌	❌
Preview	❌	❌	❌	✅
Shape	✅	✅	✅	✅
Sticky note	✅	✅	✅	✅
Stroke	❌	❌	❌	❌
SVG	❌	❌	❌	✅
Table	❌	❌	❌	❌
Tag	✅	✅	✅	✅
Team (Enterprise plan only)	✅	✅	✅	✅
Team member (Enterprise plan only)	✅	✅	✅	✅
Team settings (Enterprise plan only)	❌	✅	✅	❌
Text	✅	✅	✅	✅
USM	❌	❌	❌	❌
Webhook	✅	✅	✅	✅
Webscreen	❌	❌	❌	❌
Wireframe	❌	❌	❌	❌