Skip to main content

Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development. See documentation at <a href="https://developers.miro.com/docs">developers.miro.com</a>

  • 991 Topics
  • 3,141 Replies
991 Topics
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
Find us on Developer Q&A the first Wednesday of each month

Hey, Miro developers! We’d like to invite you to join our monthly Developer Q&amp;A sessions, a dedicated time for you to get insights on any questions or topics you might have. It is hosted by our Developer Relations team and often we will also have special guests from the Developer Platform engineering and product team to cover more specific topics.  When: The first Wednesday of each month at 5:30PM CEST/ 9:30AM CT, lasting for 30 min. Where: on our Discord channel #developer-Q&amp;A-sessionsWho can join: everyone exploring or building with the Miro Developer Platform is welcome to join - no matter how much experience you have with the Platform, this time is for you.  How to submit topics for discussion:Interested in exploring a specific topic, or have questions on something in particular? Feel free to let us know by adding a comment in this thread or sharing your ideas with us on Discord! For more common questions and topics, feel free to bring up during the session - no advance nee

3334
William Bishop
Mironeer
6 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
ServiceRocket builds 3 new apps on top of the Miro Developer Platform

ServiceRocket builds 3 new apps on top of the Miro Developer Platform Hey, developers!Want to learn more about the art of the possible on our developer platform? ServiceRocket has just launched 3 new enterprise-ready integrations for Salesforce, GitHub, and Autodesk—each built on top of Miro’s Web SDK and REST APIs. Check them out here:Salesforce for MiroThe Salesforce for Miro app enables users to interact with Salesforce data from directly within their Miro board. With this new app, you can now use Miro to manage sales activities, account planning, opportunity management, and more, with a direct connection between Salesforce and Miro.📽️ Watch the demo GitHub for MiroThis realtime, bi-directional sync between GitHub and Miro enhances collaboration across platforms, reduces costs for product and engineering organizations, and increases efficiency. With the GitHub Connector, you can bulk convert GitHub issues to cards in Miro, search and add issues, and more, facilitating better produc

1150
William Bishop
Mironeer
6 months ago
M
marcfonBeginner
asked in Developer platform and APIs
How to get the metadata for a preview type item?

How do I get the metadata from an `preview` type item? The preview items contain urls to external pages that I need to extract. [ { "output": [ { "id": "3458764612000528999", "type": "preview", "geometry": { "width": 250, "height": 223.5234375 }, "position": { "x": -340.9169006347656, "y": -154.68751525878906, "origin": "center", "relativeTo": "canvas_center" }, "links": { "self": "https://api.miro.com/v2/boards/uXjVLyMfaRI%3D/items/3458764612000528999" }, "createdAt": "2025-01-01T19:01:43Z", "createdBy": { "id": "3074457346783176524", "type": "user" }, "isSupported": false, "modifiedAt": "2025-01-01T19:01:43Z", "modifiedBy": { "id": "3074457346783176524", "type": "user" } } ] }] I also found that when you slect type `preview` from the dropdown in the official api doc

399
Horea Porutiu
Mironeer
5 hours ago
A
aes256Beginner
asked in Developer platform and APIs
Display bug with large shapes becoming more squared

Hi all,since some time I am experiencing roundish shapes that are very large to be displayed as more squared, e.g. this selected circular shape is displayed like a squared shape instead of its actual shape.It happens not reliably but very often once the board is loaded and I start editing shapes that lie within the shapes on my board with a lot of items on it (4000).When the shape is edited (but not just moved around) it returns to its correct shape.Happy to help out with logs and stuff.Cheers

182
A
3 days ago
O
OlehBeginner
asked in Developer platform and APIs
I don't see my app on a toolbar

Unexpectedly I don’t have my app on a toolbar. I had it but now I don’t. I don’t understand why( I have already tried all teams and boards and even different browsers but still can’t find my app.And I see here https://miro.com/app/settings/team/3458764611114804267/apps-and-integrationsthat the app is installed. Can anyone help me, please ?

6611
O
4 days ago
Kiron Bondale
Kiron BondaleVolunteer Community Moderator
asked in Developer platform and APIs
Simple random number generator?

Would there be a quick and dirty way to create a random number widget/addin which could be used for things like simulating a coin flip or rolling a dice?  Right now, I’m using an external URL to Google Dice but would prefer something which didn’t require learners to jump out of their class boards. Thanks! Kiron

1414545
ElvaMiro
Mironeer
10 days ago
A
Amir Ben AriBeginner
asked in Developer platform and APIs
App MetadataData / Item Metadata persistence when duplicating board not working as expected?

Hey everyone,Following this documentation about Storage, I might not understand it correctly or it may not be working as expected.Regarding App Metadata and Item Metadata, for both it says:How is it stored? → Per board, per app (and per board Item for Item metadata).If I make a copy of a board, will the data persist? → for App Metadata and Item Metadata it is marked with a V, and for collection X. It sounds somewhat contradictory to me.. but I expected that when I duplicate a board, both metadatas (App and Item) will be copied from board to board.I tried to test it. I’m developing a Miro App which upserts metadata upon icon click, where metadataKey=”key”. It also have a Shape with metadata. Both holding {“hello”:”world”}.I then went to the list of boards. Selected it, and then clicked on Duplicate.In the new board, when the App loads - it doesn’t see any previous App metadata (via getAppMetadata(‘key’)). And the Shape .getMeatadata() also returns empty.[Note: As as developer, I’ve test

191
Horea Porutiu
Mironeer
12 days ago
M
Maximilian HallettNew Here
asked in Developer platform and APIs
Connection Lines Size

A small question that probably doesn't have a solution yet. Is there way to get around the scaling parameters for the connection lines feature? I want to make my lines thicker in appearance because of the scales that I am working within my Miro Board. Subsequently my connection lines are thin in appearance even when set to the maximum thickness.

17264
S
15 days ago
B
Bradley ButcherNew Here
asked in Developer platform and APIs
App initizalization failure

The board is just loading and says something about the system failure. Does anyone have this problem now? 

4663
Eca
Mironeer
19 days ago
R
rahul.podNew Here
asked in Developer platform and APIs
Facing issues with authorization in my Django app

I am facing authorization issues with my django app. Context: I have a django app that provides an option for the users to authorize their miro accounts and access their miro boards within the app. It has the following view for authorization and callbacks: @login_requireddef miro_authorize(request):    profile = request.user.profile     if not profile.miro_client_id or not profile.miro_client_secret:        messages.error(request, "Please update your Miro Client ID and Client Secret in your profile.")        return redirect('profile')       # Redirect the user to Miro's OAuth2 authorization page    redirect_uri = settings.MIRO_REDIRECT_URI    scope = "boards:write boards:read"     miro_auth_url = f"https://miro.com/oauth/authorize?response_type=code&amp;client_id={profile.miro_client_id}&amp;redirect_uri={redirect_uri}&amp;scope={scope}"       return redirect(miro_auth_url) @login_requireddef miro_callback(request):    code = request.GET.get('code')    profile = request.user.profile  

501
Ruslan Kotowski
Mironeer
20 days ago
T
Tamara DelicNew Here
asked in Developer platform and APIs
Transparent Frame with Rest API

Even though, in REST API Reference I found default fillColor for frame is #ffffff ( ‘transparent’ ), I get WHITE frame when created. How to create transparent frame with Rest API? Is it only possible with Web SDK by setting frame fillColor to ‘transparent’?Thank you in advance,Tamara

863
Horea Porutiu
Mironeer
21 days ago
H
HughMacdonaldNew Here
asked in Developer platform and APIs
Bug: Code block internals change size between editing and viewing

I hope this is the right place to report a bug - I couldn’t find anywhere obvious to do it. When working with code blocks in Miro (I’m using the desktop app in Windows), the font is a slightly different size when editing vs viewing. And when I click off the code block, it calculates the size based on the editing size, and not the viewing size. This only really shows itself from about 25 lines and longer. Here’s an example with 30 lines in a code block While editing:And as soon as I click out to stop editing:The only way I’ve found to fix this is to turn line numbers off and on again, and it resizes to the size it should be

90
H
22 days ago
S
Sayaka HoriguchiBeginner
asked in Developer platform and APIs
App submission is stuck

I submitted three applications (MAPR-1186, 1187, 1188) to the Marketplace on November 18th, but their status remains as "submitted".I have sent follow-up emails to the JIRA ticket but haven't received any response. Could you please help us check the current review status of our applications?

487
S
24 days ago
Ronny Roeller
Ronny RoellerBeginner
posted in Developer platform and APIs
App submission is stuck

Our app (ID 3074457347393893408) is in the state “Submitted” since months. I don’t recall as ever getting a message about it.We’re can’t resubmit it with updated content again (this gives 422 error in DevTools).

463
T
29 days ago
C
captinSharkyYNew Here
asked in Developer platform and APIs
for someone need to see the demo enterprise plan ??

I want to test for the enterprise plan I dont want to spend my time and money blindly 

191
ElvaMiro
Mironeer
30 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Handling 307 Redirects and Token Issues in Miro API Requests

Hey community,I’m facing a tricky issue with my application when fetching boards, items, images, and document binaries using the Miro API.Here’s the flow:Token Generation: Each time the application starts, it obtains a token to authenticate API requests. Handling Redirects: When fetching images and binary documents, I receive a 307 Redirect. I handle this by extracting the Location header and redirecting accordingly.This works fine up to this point.However, the issue arises after the redirect:The redirected host requires a new token, causing my application to break since subsequent requests still use the old token.My experience with APIs suggests it’s possible to maintain multiple valid tokens simultaneously for different requests.My Question:Why does the Miro API invalidate - delete the old token when a new one is generated?Is it possible to have multiple tokens active at the same time for different requests in Miro?Any insights or suggestions would be greatly appreciated!Let me know

836
V
30 days ago
D
DavNew Here
asked in Developer platform and APIs
Whitelist ?

Hi, A Student in our school will be using Miro, as part of his Uni application, is there a URL whitelist available so no problems arise on the day ?

251
Eca
Mironeer
1 month ago
godofprogrammer
godofprogrammerBeginner
posted in Developer platform and APIs
Curious about Plugins

Can you guys please suggest me some best Miro templates or plugins for managing large-scale project workflows. I am asking for one of my client, where I have to handle his website and they guys are offering translation services for families. You know you involves multi-lingual barriers along with the legal actions, so need something should be highly accurate.Thanks in advance if you find this one interesting.

313
godofprogrammer
1 month ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Custom Item Creation in Miro Partner Apps: Is It Possible?

Hey community,I hope you're all doing well!I've been asking a lot of questions lately, and here's another one:Is it possible for Miro partners to create custom item types within their apps?For example, can an app from the Miro Marketplace introduce a unique item type with specific features?I know this might be a bit ambitious, but I’d love to hear if this capability exists or if there are plans to implement something like this in the future.Plus, is there any endpoint that is lists all the possible item types?Thanks in advance for your insights!Best regards,Vas

211
William Bishop
Mironeer
1 month ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Issue with Pagination Behavior on Miro Groups Endpoint

Hey community,I'm experiencing an issue with the Miro API when using the groups endpoint:https://api.miro.com/v2/boards/{board_id}/groups?limit=50The pagination doesn't seem to work as expected. Instead of navigating to the next page of groups, it redirects me to pagination for items.Is this the expected behavior, or could it be a bug? Any insights would be appreciated!Thanks in advance!Payload: 

333
Horea Porutiu
Mironeer
1 month ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Questions About Image Handling and Query Parameters in Miro API

Hey community,I have a couple of questions regarding image handling in the Miro API: Differentiating Uploaded vs. Predefined Images Is there a way to distinguish between images I’ve uploaded and those predefined on a board template? Fetching Image Files To fetch the actual JPG of an image, I currently have to follow this three-step process: Step 1: Make a request to fetch items and grab the imageUrl. Step 2: Request the imageUrl to obtain another URL. Step 3: Make a final request to the new URL to fetch the JPG. The URLs include query parameters like Signature and Key-Pair-Id. What is the purpose of these parameters, and is it possible to use them to group predefined images on boards? Any help would be greatly appreciated! Thanks!

292
V
1 month ago
J
Jairo da Costa Barbosa FilhoNew Here
posted in Developer platform and APIs
Cant change to Free Restricted SCIM API

Im trying to do a script powershell with a function who changes ‘userType’ from ‘Full’ to  ‘Free Restricted’, but it dont work (error 400 ). I tried with PUT and PATCH methods.  If i try to change from ‘Full’ to ‘Free Restricted’ it works properly. Can i have a support? Thanks!

3999
Horea Porutiu
Mironeer
1 month ago
C
CuchulainBeginner
asked in Developer platform and APIs
Permission problem with Python Flask Sample app

Hi all,I followed the instructions to get the Python flask app up and running, but I get an error with the final create_board method. The app has the boards:write boards:read scope. Would anyone have any ideas? Many thanks. /CThe API response for your code exchange request: {  "user_id" : "n",  "scope" : "boards:write boards:read",  "expires_in" : 3599,  "refresh_token" : "t1",  "token_type" : "bearer",  "access_token" : "a",  "team_id" : "t2"}INFO: GET /callback?code=eyJtaXJvLm9yaWdpbiI6ImV1MDEifQ_EypQq0&amp;state=&amp;client_id=1&amp;team_id=t2 HTTP/1.1" 200 -INFO: "GET /favicon.ico HTTP/1.1" 404 -INFO:root:Creating board with access token: valid_token&lt;Response [403]&gt;INFO:root:Create board response status code: 403ERROR:root:Failed to create board. Status code: 403, Response: {  "type" : "error",  "code" : "4.0602",  "message" : "Insufficient permissions to perform operation. Please check the permissions or contact support",  "status" : 403}

462
C
1 month ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Seeking Advice on Increasing Miro API Rate Limit for Enterprise Account

Hello Community,I'm currently encountering an issue with rate limiting in Miro’s API, as outlined in their documentation(https://developers.miro.com/reference/rate-limiting).I have an Enterprise account, which provides a limit of 100,000 credits per minute.I’m wondering if there is any way to increase this limit.Specifically:Is this rate limit fixed for the Enterprise plan? Are there options to increase the limit without switching plans? Would upgrading to a different plan help?Any insights or advice would be greatly appreciated.Thanks in advance!Best regards,Vas

261
Horea Porutiu
Mironeer
1 month ago
S
Sven12345New Here
asked in Developer platform and APIs
SAML SSO using NetScaler

Hello,unfortunately the support seems to be from the US only. Since I am from Germany it is not really possible to solve problems in a quick manner, so I hope the community can help me.Is anyone using SAML SSO successfully with Citrix NetScaler? I can’t make it work. NetScaler is reporting that it can’t find the target URL and I am not really sure why.We are using several other products with SAML SSO without any issues. When using the SAML Tracer to identify the problem I can see that other SPs are sending a metadata file in a second POST step after the inital call of the login page. Miro is not doing that I am sure this is the reason I can’t make it work with NetScaler.Or maybe I am just missing something, so any help is greatly appreciated.Thanks!

310
S
1 month ago
Terms & Conditions