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>

  • 986 Topics
  • 3,115 Replies
986 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

3064
William Bishop
Mironeer
5 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

1090
William Bishop
Mironeer
6 months 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? 

3953
Eca
Mironeer
2 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  

211
Ruslan Kotowski
Mironeer
2 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

563
Horea Porutiu
Mironeer
3 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

60
H
4 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?

407
S
7 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).

393
T
12 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 

121
ElvaMiro
Mironeer
12 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

576
V
13 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 ?

171
Eca
Mironeer
15 days 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.

223
godofprogrammer
17 days 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

141
William Bishop
Mironeer
18 days 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: 

253
Horea Porutiu
Mironeer
19 days 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!

222
V
19 days 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!

3879
Horea Porutiu
Mironeer
23 days 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}

392
C
23 days 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

181
Horea Porutiu
Mironeer
24 days 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!

280
S
24 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Inquiry About Board Visibility Delay in Miro API

Hello Community,I have a question regarding the Miro API that I hope someone can help clarify.I've noticed that there seems to be a significant delay between the time I create a board in the Miro web UI and when it becomes accessible via the endpoint `https://api.miro.com/v2/boards/`. Can anyone provide insight into the exact time it typically takes for this API, specifically this endpoint, to reflect newly created boards?Additionally, I've encountered a peculiar situation where some freshly created boards are not visible through the `https://api.miro.com/v2/boards/` endpoint, yet they can be accessed using `https://api.miro.com/v2/boards/{board_id}` endpoint (with the board ID retrieved from the Miro web UI URL). Can someone explain this inconsistency in visibility?Thank you in advance for your assistance!Best regards,  Vas

232
Horea Porutiu
Mironeer
25 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Understanding Miro User License Options and API Usage

Hello community, I'm currently working with the Miro API endpoint:https://api.miro.com/v2/orgs/{org_id}/members In this endpoint, I noticed that there is a `license` query parameter.After conducting some tests within my enterprise organization, I found that I could only create users with the full and free license attributes.I would like to understand how I can set some users to have the following license attributes:- occasional, free_restricted, full trial and unknown. Could someone please explain the different license options available in Miro and how to implement them through the API?Thanks in advance,BR Vas 

631
Horea Porutiu
Mironeer
27 days ago
L
LethNew Here
asked in Developer platform and APIs
My Miro dashboard is not loading.

When I am going into the miro dashboard it won’t load. And when I press a miro invite link to a miro board, the board doesn’t work, I can only look around.

120
L
27 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Inquiry About Error Messages for Miro REST API

Hello community,I noticed that there are details about error messages related to the SCIM API available at this link: https://developers.miro.com/docs/errorsHowever, I am looking for similar information regarding the Miro REST API.I haven't been able to find any documentation on possible errors for the REST API.I have encountered some errors during my work, and they do not correspond with those listed for the SCIM API.Am I overlooking something?Thank you for your assistance!BRVas 

221
William Bishop
Mironeer
1 month ago
V
vkokoActive Contributor
posted in Developer platform and APIs
Clarification on Pagination for Boards and Items

Hello Community,I’ve been exploring pagination for boards and items in the API.I noticed that while boards support offset-based pagination, items don’t seem to provide any offset-related information.Will offset-based pagination be implemented for items as well?Is there a specific reason for this inconsistency, or am I possibly missing something in the documentation?Looking forward to your insights.Best regards,Vasileios

161
William Bishop
Mironeer
1 month ago
G
Guru IntegrationsNew Here
asked in Developer platform and APIs
API "self" Link returns 400 Error

Hi There,I am using the /boards/{boardId}/items endpoint to return all items on a specific board. In the response, I’m getting a number of items returned, and each of those items has a API URL value in the data.links.self field. However, for some of those values, calling the GET endpoint returns a 400 error (code: operationNotSupported).Example response from /boards/{boardId}/items:{ "size": 10, "limit": 10, "total": 11, "data": [ { "id": "3458764607565328883", "type": "shape", "geometry": { "width": 262.06732667592587, "height": 131.03366630422926 }, "position": { "x": -246.9185046725638, "y": 395.1632647477584, "origin": "center", "relativeTo": "canvas_center" }, "links": { "self": "https://api.miro.com/v2/boards/uXjVLCuZXck%3D/items/3458764607565328883" }, "createdAt": "2024-11-19T18:44:56Z", "createdBy": { "id": "3458764584978600694", "type": "user" }, "

511
William Bishop
Mironeer
1 month ago
Terms & Conditions