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>

  • 969 Topics
  • 3,076 Replies
969 Topics
S
saifisBeginner
asked in Developer platform and APIs
How to get drag and drop event to get coordinates

I’m making an app where dropping a card on top of a shape object needs some functions to be called, so I want to catch when cards are moved, I tried using “WIDGETS_TRANSFORMATION_UPDATED”  but it doesn’t give coordinates, I’ve tried getting the common ‘dragend’ on document and it did no go well either, any suggestions would be greatly appreciated.

32593
J
3 years ago
M
mrowe23New Here
asked in Developer platform and APIs
Suggestions/Proxy Application Templates for Azure?

Hello,We are looking to integrate creating and displaying MIRO boards in SharePoint Online.  It looks like MIRO doesn’t allow cross domain REST calls(CORS security) from the browser.  We are looking to create a web application in Azure to be a proxy. Is there any Azure articles/apps already created for MIRO proxies that can help us get started?  Thank you,Mike 

652
M
3 years ago
G
Gaurav YadavNew Here
asked in Developer platform and APIs
DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.

When using `Editable boards for not registered users`, when I click on “Create Board”, I am getting an alert message saying “miro.com says Something went wrong” and in my console I get 2 errors`DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.``Uncaught (in promise) DOMException: Failed to execute 'postMessage' on 'Window': Response object could not be cloned.` It works fine for users that have already registered with Miro. I have attached the necessary screenshots below.Error when clicking on “Create Board”Code for opening the board picker   

86652
G
3 years ago
D
David RichardsonNew Here
posted in Developer platform and APIs
Extract Card Names From a Board

Hi.I need to extract the names of cards from a board programmatically.Been reading your REST API documentation.Am confused about how to generate the access token.We use Azure AD as our Authorisation Server.Do you have some really simple examples of how to do this?Many thanks.Dave.

863
Anthony Roux
Mironeer
3 years ago
N
NiucoBeginner
asked in Developer platform and APIs
Developer Account

Hello, I'm developing an App but I have to test it by using an endpoint that is just available for Paying accounts. Is there any developer account for this case? Cheers

975
Anthony Roux
Mironeer
3 years ago
ronny
ronnyContributor
asked in Developer platform and APIs
Upload image into board

I managed to upload the logo of the board via the picture endpoint (https://developers.miro.com/reference#create-or-update-picture). How can I upload an image to the board itself? Use case: We want to upload our logo via the API when creating new boards.

53326
Anthony Roux
Mironeer
3 years ago
M
Mariappan SubramanianNew Here
asked in Developer platform and APIs
Getting user is not in account when hitting share board api

Hi, As per documentation `https://api.miro.com/v1/boards/id/share` requires array of emails Array of emails of users who you want to invite to the board. These users can be registered or non-registered.When I try with a non-registered user it gives the error ‘user is not in the team’. Why is it so? Can’t we invite someone who is not in the team even if it’s a public shared board? If we need to do this, should we initially hit the invite to team endpoint &amp; then call this endpoint. Response: 400 "{ "status" : 400, "code" : "userIsNotInAccount", "message" : "User is not in account", "type" : "error" }"

3541
Anthony Roux
Mironeer
3 years ago
P
PetterNew Here
asked in Developer platform and APIs
Miro enterprise license - whiteboard, chat and video with guests

Hi all,We have an enterprise plan with Miro, and we want to use both chat and video with our guest users. We are planning to integrate Miro with ServiceNow, create a board via REST API, and then sharing the link with our users so they can share a whiteboard session including chat &amp; video.Is it possible to use both chat AND video with guest users, if you have an enterprise plan? Also, is it possible to use some sort of templating for the boards you create? Like adding some text, or welcoming message on the board when it opens? Best regards,P

691
Rich Moore
Mironeer
3 years ago
J
John RocheBeginner
asked in Developer platform and APIs
User Bearer Token returning Unauthorised from API call.

I have a user on the system whose User Bearer Token is returning Unauthorised when we call the Miro API. Other users bearer tokens are fine with the same calls.Can you please let me know how to refresh the bearer token for this user or enable this token to be authorized?This user has many associated boards which they will still need to be able to retrieve.

1764
J
3 years ago
K
Kamalesh JoshiNew Here
posted in Developer platform and APIs
Uncaught in promise error

I am developing a plugin using web api, where I read the miro board contents from javascript:Sample code:async function javascriptFunction() {          let selectedWidgets = await miro.board.selection.get() }This code works fine first time, but when the app is launched again, it gives error: Uncaught (in Promise) TypeError: cannot read property 'selection’ of undefined.  Anyone else faced this issue? 

2861
Anthony Roux
Mironeer
3 years ago
F
ftassiNew Here
posted in Developer platform and APIs
WebPlugin error. Uncaught Error: processCommandFromIFrame:: iframe channel not found

Hi, I’ve created a simple test plugin using one of the examples app as a scaffolding. The web plugin allows the user to roll a number of random dice. This is the installation link for the  app (still in development of course) https://miro.com/oauth/authorize/?response_type=token&amp;client_id=3074457350145576827&amp;redirect_uri=https://miro-rory-story-cubes-prod.herokuapp.com/auth-success.htmlThe app seems to work fine most of the time but for some users and on some teams, it works just once. After first usage we get this error:Uncaught Error: processCommandFromIFrame:: iframe channel not found, plugin = 3074457350145576827, cmd = .board.viewport.getViewportIf we reload the board and use it, it works the first time and triggers the error from then on.The issue seems to be consistent for certain combination of user/team/browser. EgI can use it on Team A, always I can use it on Team B, always, using firefox I can use it on Team B, only once, using chrome A teamamate can use it on Team B

6623
G
3 years ago
M
Manjula ManoharanBeginner
asked in Developer platform and APIs
Issue while embedding link

I am using Angular 6 , and when I tried to embed the below link &lt;iframe [src]='https://miro.com/app/board/o9J_ldxFWKw=/'&gt;&lt;/iframe&gt; I am getting the below error in console.Refused to display 'https://miro.com/app/board/o9J_ldxFWKw=/' in a frame because it set 'X-Frame-Options' to 'sameorigin'. any help would be highly appreciated.

12993
L
3 years ago
ronny
ronnyContributor
posted in Developer platform and APIs
Label widgets via API

We try to add labels to widgets via the API (as you can do in Miro UI) but we fail to find out to do this via the REST API. Could you point to docu how to do this? PS: Our use case is to set the labels during createWidget request.  

223417
Anthony Roux
Mironeer
3 years ago
M
Mike HosseiniNew Here
asked in Developer platform and APIs
Integration issues....

We have two main issues integrating with Miro: App URL + BoardPicker AllowList: since every single user in our app has a workspace URL subdomain, we need that Miro accepts a wildcard name here. Like *.domain.com Enabling boardPicker: by default, this feature is disabled, and Miro's users should submit a form to activate it. We have submitted that form twice, months ago, and didn't get any response from them. Can someone from the team please help us out with these?Regards,Mike

412
M
3 years ago
C
Charles FriedoBeginner
asked in Developer platform and APIs
How I can import visualization in miro from Google Sheets and/or Excel?

Hey Friends,I am creating data visualizations on different domain data.Normally I am using Google Sheets for No Code add-on for this purpose.I have more knowledge about Excel &amp; Office 365 use code free add-in for data visualization purpose.Recently created Sankey chart (Users Search Terms Flow in running campaign) with these add-ins. Image is attached. How I can import this chart in miro for data story telling purpose.Thanks--CF   

28082
Max Harper
3 years ago
R
RamkumarBeginner
posted in Developer platform and APIs
Bug - Miro selection API doesn't allow edit

Hi,When selecting widgets with Miro SDK, widgets get selected as expected but they don’t allow regular keyboard edit options like delete or arrow keys for nudging. The same work as expected when widgets are selected manually.miro.board.selection.selectWidgets([...selectableWidgets]);Regards,Ramkumar

562
Anthony Roux
Mironeer
3 years ago
Iraklis Alexopoulos
Iraklis AlexopoulosBeginner
posted in Developer platform and APIs
Transfer Miro embed app ownership

Hi there, I am trying to transfer an app that was created from a developer that used to work with us under my account. Apparently, I am listed as a team member in this app, but it’s nowhere to be seen under the apps that I can see in my dashboard. Who should I reach out to? Thanks,Iraklis

593
Iraklis Alexopoulos
3 years ago
I
Imi TuriNew Here
asked in Developer platform and APIs
AWS Icons from API

Hey, I wonder if I missed something in the API docs, but seems like currently it’s not possible creating objects from the AWS icon set via the API.Can you please provide some timing on this? 

2051
Anthony Roux
Mironeer
3 years ago
J
Justin BarrettBeginner
asked in Developer platform and APIs
Board name length limit missing from API docs

I just discovered the hard way that there’s a name length limit for Miro boards when creating them via the API: 60 characters. I discovered this when a client reported that a system that I’d built for him to automatically create new Miro boards for his projects came back with a failure on one particular project. In the API call, the only thing that I’m passing is the board name, and the intended board name for this project was 66 characters long. Through trial and error, I found the 60 character limit, but was a bit frustrated that this isn’t mentioned in the API docs.Could someone please update the docs to mention this limit, and maybe any other name length limits that need to be considered when using the API?

982
J
3 years ago
K
Kaur KuutBeginner
posted in Developer platform and APIs
Miro - where teams get no events?

I am talking about the Miro web plugin SDK and its capabilities.The main Miro landing page talks about how great Miro is for teams and collaboration. So you can imagine my surprise to learn that the SDK events are only for single user boards. There are no events for changes to the board made by my team!What makes this even more bizarre, is that these events do exist under the hood. When a team member moves a widget around, I can see it moving around on my Miro board. When a team member creates a new widget, it immediately appears in my view too!So I’m left only to speculate why these events aren’t propagated through the SDK and instead the SDK gets filtered events of only actions that I myself have done.Please tell me there are plans to add SDK event support for boards used by more than one person. It would allow for much more advanced and live collaboration oriented plugins. PS. I am aware of extreme workarounds like building a state machine with a hidden widget, or a state machine on

721
Anthony Roux
Mironeer
3 years ago
A
Andreas S.New Here
asked in Developer platform and APIs
Metadata not returned via JS SDK for widgettype=CARD

Hi, this topic is maybe connected to https://community.miro.com/developer-platform-and-apis-57/unable-to-get-card-metadata-with-rest-api-1921. But in my opinion it was not answered becuase the question was about widgetType=CARD and the answer was widgetType=STICKER. So:I created a CARD via REST API (POST https://api.miro.com/v1/boards/${this._miro.boardId}/widgets ) with a metadata. I created a STICKER via REST API (POST https://api.miro.com/v1/boards/${this._miro.boardId}/widgets ) with the exact same metadata object like in 1. In the Browsers DEV Console I did a miro.board.widgets.get({id: "&lt;id of the created STICKER&gt;"}) → Result: the metadata was returned as expected In the Browsers DEV Console I did a miro.board.widgets.get({id: "&lt;id of the created CARD&gt;"}) → Result: the metadata object was empty. Expected was the same metadata content like in 3.So for me the behaviour for CARDs is different from the behaviour of STICKERs. Does this somehow make sense? Sorry if not repr

1051
Falk Kühnel
3 years ago
K
Kaur KuutBeginner
posted in Developer platform and APIs
High frequency transformation update event

I am talking about the Miro web plugin SDK and its capabilities.I am successfully using the WIDGETS_TRANSFORMATION_UPDATED event to react to widget transformations like resizing and draging.The problem is with the eventually consistent nature of this event. The event only fires when I release my mouse button and stop resizing or moving a widget. I would like to react to these changes quicker on the fly as the widget is still being resized or moved around.The basic use case is that I want to change the background color of sticky notes depending on their location on the canvas. Currently the user has to already know where these special areas are and then drop the widget in that location. It would be a much smoother user experience if I could update the color of the sticky note immediately as it enters the correct area.This type of feature is known as a drop hint and it is commonly found in high quality UIs.The Miro web client already has all this data, because obviously the vanilla widge

923
Anthony Roux
Mironeer
3 years ago
P
Phani Sai Manohar GandrakotaNew Here
asked in Developer platform and APIs
Miro API's require Session token. How to generate session tokens ?

Hi team  I am trying to use https://miro.com/api/v1/organizations/id/members API and it seems it requires a session token. Can anyone help me with steps to acquire session token for MIRO. 

5853
Anthony Roux
Mironeer
3 years ago
R
RamBeginner
asked in Developer platform and APIs
Need some changes on whiteboard

Hey..I have two questions we are use Miro whiteboard API. And works well. Now we need to change our company logo to whiteboard. But there is already a micro logo. How to switch ? and also,we need to hide some icons like settings. how to do that..?

3687
mlanders
3 years ago
K
kirillkirillkirillBeginner
posted in Developer platform and APIs
Unknown error when creating an app

When creating an app and getting a token for our current team I get this error.If I try token for DevTeam everything is ok but when I try it for existing one I get an error. What’s the problem? 

4071
Anthony Roux
Mironeer
3 years ago
Terms & Conditions