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 | ❌ | ❌ | ❌ | ❌ |
Updated about 2 months ago