Developer platform and APIs

We have a need to pull the company users list and validate user who have a license that they have been active in the last 60 days. If they have not been active, we move their license to Free Restricted to free up the license for another user. We currently implement this by download the user.xlsx from Miro but would like to perform this via API. Is there any APIs that allow this functionality?

I have no experience with REST API and this is a rudimentary question. I want to test Miro's REST API on Power Plartform.I need to create a "custom connector" for testing, but when I set the "authentication type" to OAuth2.0 (the identity provider was set to "Generic Oauth2")・ Authorization URL・ Token URL・ Refresh URLHow should I set it? (Especially I'm not sure how to set the redirect URL.)I set it referring to "https://developers.miro.com/reference/oauth-20-authorization-v2", but it didn't work because "tokenNot Provided" was displayed.Please help me if you like.

I’m trying to set the color of a sticker using the REST API, but not having much luck.  When I set style.backgroundColor to any value other than “#fff9b1” I get an result of error code 400 (Bad Request).  Are there only certain allowed values?  Could these be specified in the documentation?

When I use the miro rest api to create a text widget, the height is not set correctly: However, editing the text as a user - such as entering edit mode, or selecting and then bolding, corrects it: Using the miro sdk (not api) to update a text’s width, bold, or even just select it does not fix it either - only doing a user actionAny ideas of a possible fix?Also of note: padding seems to break behaviour entirely, with inconsistent width and wrappings even between refreshes.

I’ve been trying a variety of ways to install the Jira Cards add-on. I’m able to install the app, but then not able to connect my personal account. Do I need to be an admin to connect my Jira account? or did I miss some configuration?

Hi there,I’m currently working on a miro Web Plugin. I created the initial code base with the create-miro-app cli and deploy it via GitHub actions to GitHub pages.The plugin works fine at first, but suddenly stops working after some time. In the browser console I see the following errors, right before the plugin stops working:cmn~app.cor~2d10ec5e.bcac00ff50944884.js:2 Response by token not found .areYouAlive-9lCcpb7KdjdnlwqCSp73followed byUncaught Error: processCommandFromIFrame:: iframe channel not found, plugin = <my appid>, cmd = IS_RESPONSE_FOR_SOME_COMMAND at t.processCommandFromIFrame I’ve no idea what could be causing this.The plugin is open source and you will find the source code at: https://github.com/stefan-spittank/miro-affinity-diagram-tools.Any ideas?

have been trying to get miroBoard picker working for a while now. have submitted the app twice, and it was working for a while, but then it stopped. When we try to go ‘whiltelist’ the domain, it won’t let us → it says it’s an invalid domain, no matter what we put in (including localhost) Been struggling for about 2 months now, have sent in multiple enquiries, but no response. have a paid account with 20 members. any tips?

Hi, since around a week I face the issue that the ‘x’ and ‘y’ attributes are missing if using the Miro REST API (old version, call get_all_widgets https://api.miro.com/v1/boards/<board_id>/widgets/ and also the get_widget call f"{self.miro_url}/{self.board_id}/widgets/{widget_id}").I see this issue for a rectangle (style/shapeType) shape (type).This does not happen for all widgets… Some reactangle shape widgets have the x/y attributes, some not.Re-creating the shape via the Miro-App brings x/y back. But randomly it disappears somehow somewhen again. Do you face the same issue?Is there any fix planned or workaound available? Thanks for the support,Sebastian

I’m trying to create some custom tools that our team can use on mobile devices. I’ve been playing with the web plugin system and finally got a basic test working, but it only works via the web interface. I’m hoping to find something that will work in the Miro mobile app, but the docs don’t make it clear which developer features are mobile-friendly, if any. I’m also not having much luck opening the web UI in a mobile browser, as it appears to be a view-only interface that doesn’t let me interact with the board.Am I out of luck, or is there something that I just haven’t found yet that will let me do what I need?

We are on a consulting plan and create a team for every client we work with. We recently put a lot of effort into creating miro templates for all our tools to realize that we have to add these to every team separately. This is not only a lot of unnecessary work every team we add a new client, it also means that we can’t change our templates centrally. The current workaround - copy pasting templates from our company team into boards for client teams -is time consuming and creates a lot of clutter in the form on unused boards on our company team. The feature to make this accessible across team accounts already exist on the enterprise plan. Given the nature of most organizations that are on the consulting plan it would make a lot of sense to add it to the consulting plan as well!

Hi there, I’ve created a Miro app which uses the OAuth flow to integrate with the REST API. A user has just tried to install the app and told me that they cannot select a team, screenshot below: As far as I can tell this is not an issue on my side, it seems like a bug with Miro - any ideas what the problem is?

Hi, I am using the new v2 REST API and I would like to use either metadata at the widget level as per the v1 API or the appData that is available through the SDK https://beta.developers.miro.com/docs/board_board#setappdata but it doesn’t appear to be exposed to the REST API board model https://beta.developers.miro.com/reference/board-modelIs that correct? Is there a plan to expose it?

Hi, are there any possibilities to get tags info from board?I want to get info from tags attached to board objects.For example, i want to read two tags from tihs sticker using API 

Dear all, I’m currently building a React app to generate automated miro exercises. The goal is that a user has the possibility to start an exercise and be directly forwarded to a board in our organization with public access rights. Currently I’m having difficulties to create these boards via the API outside the Developer Team. As far as I understood, I can export my application to other teams, but then I can't create an access token for this team or cannot access this team with my old one. It seems like I need to generate a new access token. But I’m incapable to do it. I would be happy about any help. Or please provide information on how else I could generate these boards outside the developer team. See below for my basic interaction diagram.  Thank you!Best regardsSandro

Hi, I’m building an application that transforms widgets using the REST API and I’m having some trouble understanding why the coordinates in the API response don’t seem to correspond the coordinates on my Miro board. I have for example a frame with text inside it on my board as shown below: Clearly the text is inside the frame and, to my intuitive understanding, should have a higher x coordinate than the frame which contains it. However, in my REST API response I have the following: // Frame{ "type": "frame", "x": -3587.3270314932, "y": -5206.0307250572}// Text inside frame{ "type": "text", "x": -3698.5956533089, "y": -4955.33351925148}As you can see the x coordinate has a lower value for the text than for the frame. Is there a clear description somewhere of how these coordinates are generated? (And therefore how I might manipulate them to have values that correspond to the visual appearance).

Hi there,I am trying to get all frames from a specific board via API. For any other item type the Get items by type on board method works fine for me but trying to get the frames constantly get the following error no matter for which board i try it:{  "type": "error",  "code": "internalError",  "message": "Internal server error",  "status": 500}I get the error using the API reference website for trying out. Is that a known issue? Thanks and regards,Manuel

Hello, I am integrating miro API to a third party App and I wanted to use create board and widget API, After using the OAuth to get token for authorization, and having set the required parameters as stated in the documentation, I kept getting “insufficient permission” response code. Below is the sample of response I got:{  "status" : 403,  "code" : "insufficientPermissions",  "message" : "Required scopes: boards:write",  "type" : "error"} 

I'm now trying to output a shape using the SDK. Therefore, I would like to make the characters in the figure bold. miro.board.widgets.create ({{ type:'shape', x: 0, y: 0, width: 100, height: 100, style: { textColor:'# 000000', backgroundColor:'#FFFFFF', bold: 1, borderWidth: 7, borderColor:'# 000000', fontFamily: 0, fontSize: 32, textColor:'# 000000', shapeType: 3, }, }) Even if you do, it will not be bold. Please let me know if there are any mistakes.

Can the width of the leftsidebar opened using the "openLeftSidebar" method be changed to something other than 340px? It seems that you can change the width as an option, but when I try it, it doesn't work. https://developers.miro.com/docs/web-plugins-features#render-custom-views  

I have created and am using an application that drags and drops icons. I define the permissions my app requires to modify boards when I install it, but after a certain amount of time, the permissions is broken and the following error occurs. I can't drop the icon on the board. Uncaught (in promise) Error while command execution: Method 'board.widgets.create' requires scope 'boards:write'   if anyone have an idea of how to fix it.

Hello,We want to integrate MIRO in our product. In order to do that, we want to use the boards picker API. For this, we submitted the necessary form on the 29th of April 2021.To date we have not received any answer regarding our request. I sent multiple messages on this topic to the support team but have not received any answer. Has anyone gone through the same process or can give us some tips and tricks on how to get things moving? The deadline we set for this integration is coming soon and time is of the essence.Thank you in advance for your support! 

Our company has created a dev app and applied for that app to get access boardspicker api via this form, about 20-30 days ago. I still get the ‘Sorry Integration is unavailable error, when trying to create a board by boardspicker api in my local. I have added localhost to boardspicker domain in our app settings. Here is the error. Thank You. 

Hi Miro Developer Community. Question - it seems like there is no way to do these things using the API:List all users in the company, and their license level List all teams in the company Create a new teamIs that right? I saw another post saying that you can use Get Team User Connection to list team members and their role. But that’s just for one team. Is there another method for doing this? Or is there a plan to offer this in the API? Doing these things manually is real pain if your company has hundreds of users or hundreds of teams.  Thank you in advance!

Hello!I am developing a plugin that can be opened from the Miro board. When my plug-in starts, it doesn’t check if widgets are already selected. I need the plugin to be able to detect what is currently selected when it is opened in order to improve the user experience.Has anyone figured out how to do this?Here is a video demo of the issue: 

Using this endpoint: GET https://api.miro.com/v1/teams/{id}/user-connectionswhile using the “fields” param I get server error before getting all the dataExample -First call:https://api.miro.com/v1/teams/{id}/user-connections?fields=id,role,user{id,name,email,state}&limit=100&offset=0Status 200 OK"type": "list","limit": 100,"offset": 0,"size": 288, Second call:https://api.miro.com/v1/teams/3074457346633267435/user-connections?fields=id,role,user{id,name,email,state}&limit=100&offset=100Status 200 OK"type": "list","limit": 100,"offset": 100,"size": 288, Third call:https://api.miro.com/v1/teams/3074457346633267435/user-connections?fields=id,role,user{id,name,email,state}&limit=100&offset=200Status 500 Server Error"type": "list","limit": 100,"offset": 200,"size": 288,