Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development. See documentation at developers.miro.com

  • 766 Topics
  • 2,507 Replies

766 Topics

M
Maximilian PopraweBeginner
asked in Developer platform and APIs

CORS error when accessing Miro API from Web-plugin

Hi all!I have an issue with CORS when accessing the Rest API from within a Web-plugin. As explained here, it is very easy to get a Rest Authorization Token to execute API calls from the miro SDK. However, when attempting to get a REST resource (I was getting /v1/boards/{id}/user-connections), I get a CORS exception because I call the API from the domain of my plugin. (which of course runs inside miro.com) My understanding is that the only workaround is to make the call to the API from a server and not the browser, which would require my plugin to require a server, which has a big complexity addition - it would be much simpler if it could continue to be hosted as a static website on GitHub Pages. So my question:Is there a way that I am not aware of to circumvent this problem (other than hosting a server)? If there is not, would it be possible to set the Access-Control-Allow-Origin header on requests to * (or potentially more safe to a list of addresses that could be configured on the bo

3
I
4 months ago
Marco Spinello
Mironeer
Marco SpinelloMironeer
posted in Developer platform and APIs

Miro Web SDK 2.0 introduces flowchart shapes, getOnlineUsers, online_users:updates

Good day Miro developers! 🖖 😃  The Miro Web SDK 2.0 got a couple of new features 🚀 that we’d love to share with you! 💫Flowchart shapes are now available as an additional set of shapes in the experimental shape item. ℹ️ Currently, flowchart shapes are available only in the experimental namespace: miro.board.experimental.   getOnlineUsers: how many users are currently online on a board? Use the getOnlineUsers method to fetch IDs and names of currently online users on a board.   online_users:update: apps can subscribe to the online_users:update event to register changes in the number of online board users. The event contains an array with user IDs and names of the currently online users.For more details and for links to the docs, see the changelog 📄

1
Max Harper
4 months ago
T
Tom DenbyBeginner
posted in Developer platform and APIs

npm run start

this is the first miro app i’ve tried to create, so im following the webinar here -  when i run npm run start  i get the following error,  npm ERR! Missing script: "start" seems like probably a basic error but i’ve not had it before on other solution i’ve developed, any ideas how to resolve it? 

6
T
4 months ago
S
SiegmarBeginner
posted in Developer platform and APIs

Miro Web SDK App with Python and Flask

Hi,I just published a Medium Story and a GitHub repository with a Web SDK App created with Python and Flask, instead of JavaScript and React:Medium - Miro Web SDK App with Python and FlaskGitHub - MiroSo far I did not see any incompatibility with Python, but I will continue the tests.Next steps are including Business Logic, API and OAuth 😀Thanks ( you may close the Conversation )

1
S
4 months ago
S
SiegmarBeginner
posted in Developer platform and APIs

Miro API Clients in C# and Python from OpenAPI Specification

Hi,First, congratuations for the excelent Miro documentation: probably the best I used in 30+ years 😀Based on my very long experience ( 5 days !!! ) with Miro, I just published a Medium Story and a GitHub repository with API Clients in C# and Python, based on Miro OpenAPI Specifications:Miro - Miro OpenAPI SpecificationsMedium - Create Miro API Clients in C# and Python from OpenAPI SpecificationGitHub - MiroIt could help other developers to create their own API Client in other languages. As far as I saw, currently Miro GitHub as an API Client just for Node.js/TypeScript.Thanks ( you may close the Conversation ) 

2
S
4 months ago
A
apiercedeveloperNew Here
posted in Developer platform and APIs

Can I embed Miro as a service into my application instead of a single board?

Hello Friends,I have a chat app that I would like to have blank Miro boards on. I would like each user to be able to create their own board and be able to save and share with others. When I look into embedding using Miro it looks like the ability is just to embed an existing board. My worry is that this would add one board that is shared amongst every user that when it’s customized it updates for everyone. I would like each user to start with their own blank board and the ability to create more. Is this possible? Thanks!

1
Josip Janzic
Mironeer
4 months ago
P
phil21ooNew Here
posted in Developer platform and APIs

mindmap paste in a list of topics at ones

Hello, if i have a google sheet with many topics, how can i paste them into the miro mindmap as different branches?

2
Robert Johnson
4 months ago
S
SiegmarBeginner
posted in Developer platform and APIs

Web SDk Forms

HiI am testing a more complex Web SDK Form ( using Mirotone examples ) and, so far, it is working fine.But I have some questions:(1) How do I change the App Form Pop-up size ?The current width is 368 but I did not see any CSS defining it.(2) Is there any way to get a floating Form instead of a fixed one ?As far as I understand Miro creates this Form and my App “runs” inside it, so I don’t know if I have control over it from the App code.Thanksconst App = () => { React.useEffect(() => { addSticky(); }, []); return (<div className="grid form-example"> <form className="cs1 ce12 form-example--main-content"> <div className="form-group"> <label htmlFor="form-example-input-1">Input label</label> <input className="input" type="text" id="form-example-input-1" placeholder="Enter something"/> </div> <div className="form-group"> <label htmlFor="form-example-input-3">Input label</label> <select className="select"

1
Elena Ignatik
Mironeer
4 months ago
G
Graham ClarkBeginner
posted in Developer platform and APIs

enable reddit to embed with Include Media Preview

in reddit: share>embed>copyin miro: embed iFrame code“The URL you are trying to submit is invalid” 

9
Mira Balani
Mironeer
4 months ago
T
Tammo DirksenBeginner
posted in Developer platform and APIs

Miro Web SDK REST API -> Where do I store Authentication Data

I have created a Miro app and what pretty much does is that it creates Microsoft To Do Items from Miro Cards using the Graph API and specifically several Microsoft To Do Endpoints in there. My app makes use of both the Miro REST API and the Graph REST API by Microsoft. For both I need a client secret, a refresh token and an auth token to authenticate against these apis. My plan is to use service account on the Microsoft side and another service account on the Miro side (Or actually user accounts).Since the app is built using React and Typescript (As done in one of Miro´s tutorials) I have different options to store Auth Data. I of course don´t want to do that in plain text inside my application. How should I approach this? Should I use a database or a .env file? I am happy about any suggestions and answers. :)

3
Mira Balani
Mironeer
4 months ago
T
tbadmiNew Here
posted in Developer platform and APIs

Can I use an external database to populate a Miro map?

I have a client who is looking to build a series of career maps, showcasing the relationships between and occupational data for some 60+ occupations. That number will grow over time, and each occupation will also undergo continuous updates. They’d ideally like to store all occupational data in a database that then integrates with Miro to write the occupational data into specific map objects. One of the developer forum posts I saw said that Miro maps cannot be powered/populated by external databases, but I wanted to confirm that and see if anything has since changed. Thanks!

1
Mira Balani
Mironeer
4 months ago
M
Max KovalovNew Here
posted in Developer platform and APIs

Seems like The PlantUML plugin is broken

HI,It seems like the PlantUML plugin is broken: when I open an editor, there is no rendered image for the diagram and the “Add to Board” button has an infinite loading spinner.Looking in the logs on developer console, I see a several errors for failed requests due to CORS   

2
C
Mironeer
4 months ago
G
Gaurav BhorkarNew Here
posted in Developer platform and APIs

Miro Get Boards REST API searching in board content

The Get Boards REST API has a “query” parameter where we can get boards based on the query. The documentation says the following about the query paramRetrieves a list of boards that contain the query string provided in the board content or board name.However we do not get the correct result. It only returns results by querying the board title (not the content). We have an enterprise plan (dev sandbox). Is this a bug?Just to elaborate moreWe have this board with the two stickiesOn searching for “present” the Miro UI, we get the right result.However, the API does not return the same. 

0
G
4 months ago
J
James PartingtonNew Here
posted in Developer platform and APIs

Getting 500 server error when uploading shapes

I am creating a table like object on a Miro board. Each object requires roughly 100 shapes. I am asynchronously sending HTTP requests to “https://api.miro.com/v2/boards/{board_id}/shapes”. I am aware that uploading shapes is level 2, so there should be a limit of 1000 items per minute. However, even when sending 1 http request per 0.1 seconds, some errors happen:Error uploading shape to miro, status code: 500{  "type" : "error",  "code" : "3.0023",  "context" : {    "boardId" : "uXjVPxuroBA="  },  "message" : "Internal error occurred",  "status" : 500} I could not find anything about error code 3.0023. My program works 100% okay if I wait 1 second per http request, any ideas what is causing this?

4
Mira Balani
Mironeer
4 months ago
A
Anton ShherbininBeginner
posted in Developer platform and APIs

The getSelection function incorrectly displays the connector end type.

HelloIf you select a segment on the board (a connector with empty ends) and write this code:let arrSelect = await miro.board.getSelection();console.log(arrSelect[0].style);then the end of the segment will be defined as "stealth", although in fact it should be "none" (fig. 1)If you select the first value in the list with the beginning of the arrow (Fig. 2), then it is defined as "none", which is also not true.The function works correctly with all other types of ends.

3
A
4 months ago
M
Matt LapNew Here
posted in Developer platform and APIs

File path extension on iOS?

Hello community of bright people who are much more programmatically competent than me.Is it possible to have a HUD of the filepath for different Miro boards and projects on the left side of the iOS app? Is that something that could be an extension? 

0
M
5 months ago
T
thedarkstrixContributor
posted in Developer platform and APIs

How to get the same registered miro board ?

Hi,What is the functionality that i am looking for ?When https://webwhiteboard.com/ is visited, the board that opens is unregistered miro board, but when the window is closed and when opened again the same board is shown again (the miro board is reused / the miro board is remembered), how to achieve this functionality using miro board picker (live embed) ?Current functionality is: When ever the board picker is triggered, clicking on create board (unregistered) will always open a new miro board. What i have already tried: Create a new miro board with a new jwt token , store this jwt token.Now when opening a board picker again , pass in the same function that returns the same jwt token created earlier. But this also creates a new miro board . What can i do to actually reuse the same unregistered miro board ?Also,how to get the data of which board (unregistered / registered board) the user selected from the board picker? (looking get this response in board picker success response, As ther

4
T
5 months ago
B
Ben TrottBeginner
asked in Developer platform and APIs

How to duplicate/ clone boards using the REST Api

As the title states, how can I duplicate an existing board programmatically using the REST api? I couldn’t find anything in the documentation, and get all the widgets and then creating them in a new board are not practical as this method doesn’t support frames.

19
Fredrik Wendt
5 months ago
T
thedarkstrixContributor
posted in Developer platform and APIs

Toolbar missing in unregistered boards

We are using the live embed feature , when the unregistered board is loaded , the toolbar disappears automatically but the toolbar shortcuts all work (like p (PEN) etc).Not sure why the toolbar suddenly disappeared . Looking for help regarding this.What I have already tried and failed : - Reset the cache- Using different browser- Using incognito modeWhat i have made sure : - The user the owner of the board (accessToken)- The board has not gone into view only mode- The user is able to write on the board using the toolbar shortcutsBoard URL : http://miro.com/app/live-embed/uXjVMU21pXM=/?boardAccessToken=AQ8vtfd6NXt8kfwmT4b33OkxGs8149JH&autoplay=trueAdditional info : If the were to select a registered board by selecting the board by logging in, the toolbar is visible . This is issue only happens with unregistered boards as of now. This is happening in whereby as well.ScreenshotFrom our webAppScreenshot from whereby  

4
T
5 months ago
A
Andriy ZhylenkoContributor
posted in Developer platform and APIs

Adding MindMap items via REST API?

I have a MindMap and would like to add more items there using my script. Obviously I want the new elements to have the same style as the ones already created - but they turn to be quite ugly (notice the white background of the “Sample Widget”). :-(The only differences between the “widget” object that was created manually and the one created by script areCreated on Miro UI Created by script     "id": "3458764523334544261",     "style": {         "backgroundOpacity": 1.0,         "backgroundColor": "#ffffffff",         "borderColor": "#ffffffff",         "borderStyle": "normal",         "borderOpacity": 1.0,         "borderWidth": 2.0,         "fontSize": 14,         "fontFamily": "OpenSans",         "textColor": "#1a1a1a",         "textAlign": "right",         "shapeType": "text_rect"     },     "text": "<p>SIP trunk</p>",     "x": -437.200615234375,     "y": 10.0,     "width": 56.4,     "scale": 1.0,     "rotation": 0.0,     "type"

17
William Bishop
Mironeer
5 months ago
T
thedarkstrixContributor
posted in Developer platform and APIs

Anonymous board not viewable even with accessToken

Hi,Trying to create a miro board for unregistered users (anonymous board), once the board is created the board picker returns with a accessToken which we can use to share the board with to other users . I am trying to embed the miro board in ReactNative with an iframe using WebView, even though the link has accessToken , the board always shows up as a private board for another user with the link.The code :   <WebView originWhitelist={["*"]} scalesPageToFit={false} scrollEnabled={false} ref={this.miroWhiteboardRef} style={{ flex: 1, }} source={{ // uri: whiteboard?.accessLink, html: `<iframe title="miro-whiteboard" referrerpolicy="no-referrer-when-downgrade" allow="fullscreen; clipboard-read; clipboard-write" src=${`https://miro.com/app/live-embed/${whiteboard?.accessLink}`} style="background: transparent; border: 1px solid rgb(204, 204, 204); transform: scale(calc(0

6
K
5 months ago
A
Alex KimNew Here
posted in Developer platform and APIs

Board access without miro account

Hi everyone! How can I organize access to a Miro not public board if the attendees don’t have a Miro accounts?I see that invite a team method requires userEmail (https://developers.miro.com/reference/enterprise-invite-team-member) and share a board method requires the list of email (https://developers.miro.com/reference/share-board)

0
A
5 months ago
R
Rishikul SaxenaNew Here
posted in Developer platform and APIs

API to completely delete a user account in MIRO

Is there an API to delete a user account in Miro ?I see APIs to remove members from a team but unable to find one which could delete the account altogether. 

3
I
5 months ago
W
WimGGVNew Here
posted in Developer platform and APIs

Add images to mind map nodes/topics

It would be great if images and icons could be added as nodes/topics in mind maps

1
Kiron Bondale
5 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Announcing the Developer Space, now in open beta! 🎉

Hey, Miro Developers! We’re excited to announce the open beta of a new experimental space in our developer portal, dedicated to streamlining the developer experience. Introducing the Developer Space—your one-stop shop for onboarding, progress tracking, app creation, an enhanced app management list, and more!You can access the beta version of the Developer Space here, or from the upper right-hand corner of our developer portal at developers.miro.com:We’re focused on making sure we’re meeting the right needs of developers with this new space, and your voice is invaluable to us! We’d like to hear from you and learn from your experience with our early beta!  Share any feedback or bugs with us here:Feedback on Developer Space Cheers,Miro Developer Platform Team

0
William Bishop
Mironeer
5 months ago
Terms & Conditions