Skip to main content

Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development.

  • 1,125 Topics
  • 3,437 Replies
1125 Topics
T
TudorNew Here
asked in Developer platform and APIs
Web Plugin: is it possible to add a button to the left side bar?

Hi,I’ve just finished building the simple Miro Web Plugin to count the number of widgets by type and would like to add a button on the sidebar which creates a sticky on the board with the count.I tried adding the button to HTML using the code below but the button itself is not clickable, is this not supported on the sidebar? let button = document.createElement('button');button.className = 'stat-list__button';button.innerText = 'Create Totals';button.addEventListener('click', function() { alert("Test");}, false);statView.appendChild(button);Thanks for the help!Tudor

3881
Max Harper
I
Ilyas SalikhovNew Here
asked in Developer platform and APIs
Broken line widget creating (lineEndingType incorrect)

From yesterday I see the bug in widget creating through POST https://api.miro.com/v1/boards/id/widgets Example of the POST requestPOST https://api.miro.com/v1/boards/o9J_labxxgM=/widgets v2_xiqk9VdRN__CHSzstDUsn-as {"type":"line","style":{"borderColor":"#d6d6d6","lineEndType":"opaque_arrow","lineStartType":"none","lineType":"bezier"},"startWidget":{"id":"3074457354075703371"},"endWidget":{"id":"3074457354083427696"}} In response I see that lineEndType is not that I have defined:{  "id" : "3074457354075703388",  "startWidget" : {    "id" : "3074457354075703371"  },  "endWidget" : {    "id" : "3074457354083427696"  },  "style" : {    "borderColor" : "#d6d6d6",    "borderStyle" : "normal",    "borderWidth" : 1.0,    "lineEndType" : "bezier",    "lineStartType" : null,    "lineType" : "bezier"  },  "type" : "line",  "createdAt" : "2021-02-04T11:22:48Z",  "modifiedAt" : "2021-02-04T11:22:48Z",  "modifiedBy" : {    "type" : "user",    "name" : "Ilyas Salikhov",    "id" : "3074457348081033358

983
I
F
Ferris440New Here
asked in Developer platform and APIs
Manipulation only - no new board elements?

Hi community, I’m keen to experiment with extending the Miro board with other apps that can be dropped onto the board and used by the team. E.g. and embedded version of Figma, a file store or a coding environment. I can’t use the iFrame widget for this as it defaults to just showing a preview - I want it to show the actual content of the remote session (likely with some kind of user locking mechanism). Am I correct in my understanding however that the widgets/API can only be used to create apps that manipulate existing board items (e.g. place post its) vs create new board entities (e.g. premium post it). Thanks for your help! Luke

8353
T
K
Kiril VandovNew Here
asked in Developer platform and APIs
How to setup CORS

I am working on a SPA where I am trying to create a UI on how to configure the look and types of the widgets to import. So I was wondering is there a way to set up cors in the Miro development settings that I missed?I am using directly Authorization with the Bearer token.

1631
Sami Ljimari
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs
Widget top and bottom bounds attribute inverted?

Hi, I was doing some widget plotting and detection earlier and found that widgets seem to have “reversed” values in their y-axis top and bottom bounds property. For example a fresh widget which I created with miro shape creator had these bounds:This might just be a result of different plotting technique or something but from what I know bottom y axis point should always be smaller than the top y axis point. Is this “inverted” on purpose? If yes what is the idea behind this? Also I have not made any tranformations / translations on the board or widgets. And what really bugged me is that the x-axis left and right points are plotted normally (left is on the left and right is on the right) unlike the y-axis points. From which arises another question is this actually plotted on the board in reverse or are the values just passed to the wrong attribute inside the widget data? 

1033
Max Harper
O
Omar DalgamuniNew Here
posted in Developer platform and APIs
Web plugins - similar to Looking glass?

Hello, Does anybody know of any plugin in the market similar to the plugin named Looking Glass in this guide? https://developers.miro.com/docs/web-plugin-examples#looking-glass I find it to be useful, but I figured out maybe somoeone in the community already built it from the API example and can share the finished plugin with me. Saves me a lot of time of learning how to do it myself. Thank you,Omar  

340
O
M
mokesNew Here
asked in Developer platform and APIs
Rest API: Send to Back/Bring to Front

Is there a way to change the layering of widgets on a board via the rest api?I get inconsistent layering, i think due to race conditions sending create widget requests. From what i can tell the more recently added widgets always end up on top, but i  can’t find a way to add a widget behind ones that already appear on the board.I assume i’m missing something? Thanks for the helpMokes

4321
Daniela Gavidia
Mironeer
A
Alexey D. FilimonovNew Here
posted in Developer platform and APIs
[Enterprise] Is there any way to batch upload user profile pictures when Azure AD provisioning is enabled?

Is there any way to batch upload user profile pictures when Azure AD provisioning is enabled?I could not find any SCIM options to do this. I could not find out, how to upload pictures using side scripts. I found there is API for uploading pictures, but it requires Miro’s internal user id. And there is no API to get Miro’s users ids for my enterprise.Need assistance. 

1802
A
J
John RocheBeginner
posted in Developer platform and APIs
Auto display a Miro board, embedded in a web api, after signing in

I have embedded a Miro board within a web api using the following link<iframe src="https://miro.com/app/live-embed/@Model?embedAutoplay=true&moveToViewport=-23165,-5837,13803,7546" style="right: 0; width: 100%; height: 100%; border: none;"></iframe>This enables the board to be opened automatically when the web page containing the link is displayed and the user is signed in to Miro.However, if the user is not signed in then a message to “Sign in” is displayed as below;  Now, when the user signs in, using the “Sign in” button, the iframe containing the board, is refreshed and a message says “Reconnecting” then “Connection restored” is displayed at the top of the board but the board does not display.Instead the rotating image below is displayed.  How can I embed a Miro link in a web api such that the board is auto displayed if the user is signed in or it is displayed automatically after the user signs in?   

1601
Boris Borodyansky
Mironeer
M
Murtaza JavaidNew Here
posted in Developer platform and APIs
Is it possible to create a board with public link sharing with the API?

I am thinking of a small personal app idea that could use Miro pretty well but the way I’m envisioning it, I’d rather create the board automatically and allow all the anonymous users to edit it rather than having a user create an anonymous board through `boardPicker`. Is this possible? The API suggests that only `view`, `comment`, and `private` are valid options for the public `access` field when creating a new board. I am on the consultant plan by the way.

1011
Boris Borodyansky
Mironeer
江
江國瑋New Here
asked in Developer platform and APIs
Does Miro provide an API for capturing chat room content?

Does Miro provide an API for capturing chat room content?

771
Daniela Gavidia
Mironeer
I
Ilyas AliyevNew Here
posted in Developer platform and APIs
Children are not attached to the frame.

let image = miro.board.widgets.create({type:'image', url: url, x: canvasX, y: canvasY})let text = miro.board.widgets.create({type:'shape', x: canvasX, y: canvasY, text: "<strong>Title<br/><a href='https://www.google.com/'>Google url</a></strong>"})miro.board.widgets.create({type:'frame', width: 300, height: 500, title: "Test", childrenIds: [image[0].id, text[0].id], style:{backgroundColor: "#ffffff"}})}Here is code snippet. This adds a frame and two elements to it. But frame and children don't belong each other. When i start dragging frame children stay static. Is there any way to make child elements nested to frame?

4292
M
R
Rostyslav LabaBeginner
posted in Developer platform and APIs
Generate JWT using node.js

Hi there,Currently I’m working on implementation MiroBoard for not registered users, for registered users everything works well, but for not registered users I need to generate JWT, I generated it but it seems there’s something wrong with it.Can you please share some examples of JWT generation for MiroBoard using node.js?

2384
R
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs
AreYouAlive app timeout error

Hi, after about 20-30 seconds of inactivity I get this error: Response by token not found .areYouAlive-pzexwRYT0y6q6vo4JdA5 from my app. I understand that this is triggered automatically but don’t understand how or why (since this doesn’t happen in any other ones I made) I don’t get why the token expires. Once this error gets triggered my app will not accept input, sometimes if I try to input something twice it works on the second try and sometimes the app needs a re-launch. Is there something I’m doing wrong, or some way to prevent this from happening?

4604
Sami Ljimari
A
Atanas KolevBeginner
asked in Developer platform and APIs
AccessLink and Board Duplication

Hello there,So we are trying to build a teaching app where users are taken through several stages in a lesson, one of which being able to interact on a whiteboard.For a lesson we want either a blank board or to start from a template designed for that particular topic. The board should be created from a template programmatically and embedded at the appropriate point in the lesson. This is embed it on the page so everyone would be able to see it and interact with it.After some investigation and tests we came across the following problems:1/There seems to be no way to programmatically get access-links other than using your boardPicker.js. I am aware that we are able to embed using https://miro.com/app/live-embed/{board_id}/ but this requires the user to click on the board for them to see it and we really want to avoid that.And the only option where no click is required is by using “https://miro.com/app/access-link/{the access link part}”. We want to skip the boardPicker and programmatical

1951
Boris Borodyansky
Mironeer
K
Katrien De KeyzerNew Here
posted in Developer platform and APIs
How can we save the content of postits in to a database or file where everyting comes together per topic?

I want to search a way in miro that per board people can save all the postits that are made per topic can be saved i an sort of database or frame and later other people can see the content and share and reuse some answers/postits. Maybe with integration with an app or in miro in another frame of board?ThanksKatrien

2723
Kees Froeling
J
Jerry OSullivanNew Here
asked in Developer platform and APIs
Create new card type

HiIs it possible to create a custom card type with some extra fields, happy to get stuck into some APIS if it would be possible….It’s been a few years since I did some serious coding so any Noddy guides would be helpful ThanksJ

12091
Max Harper
Iraklis Alexopoulos
Iraklis AlexopoulosBeginner
asked in Developer platform and APIs
Miro Embed - Available approaches and enablement

Hi everyone, We are looking into embedding Miro boards into our React.js application. I have read through the docs and I have applied (and got accepted by the API team) to get access to Miro Live Embed. I just have a few questions:Are all three approaches listed in the docs page above (direct board link, boards picker from JS, and temporary boards for un-registered users) available? The flow for temporary boards caters for both un-registered but also allows users to log in if they have an account. Correct?  What is meant by “… requires enablement on Miro side...”? Is there anything more required from our side, other than submitting the form above and being accepted? I created the “Dev team” as instructed by the docs. Is this the team that I will be using to also publish the integration, or can I create a new team and transfer the integration to that team. Also, I renamed the “Dev team”, any issues with that? Do you foresee any complications with trying to integrate a Miro board into a

9622
Iraklis Alexopoulos
A
AbhishekNew Here
asked in Developer platform and APIs
Miro Audit Logs

I am trying to access audit logs of my team but am unable to access it as it says bad request for every request. This is the requesthttps://api.miro.com/v1/audit/logs?createdAfter=2021-02-01T23:59:45Z&createdBefore=2021-02-05T23:59:45Z I have also tried this in case it might work but it did not work toohttps://api.miro.com/v1/audit/logs?createdAfter=2021-02-01&createdBefore=2021-02-05 I have added my authentication as Bearer {{Token}}. The response I get is 400 Bad Request:{"status": 400,"code": "invalidParameters","message": "Method arguments are not valid","context": {"fields": [{"field": "createdAfter","message": "Invalid parameter type: Date is required","reason": "invalidParameter"}]},"type": "error"} Any help here would be appreciated. Thanks in advance!

4392
A
A
Atanas KolevBeginner
asked in Developer platform and APIs
Reason is platformApplicationNotFound

I am getting the following error when i am trying to integrate MIRO board.miroBoardsPicker.open({ windowRef: windowRef, //Provide opened window reference clientId: miroClientId, // ask the backend action: "access-link", allowCreateAnonymousBoards: true, //2) Enable this option getToken: () => getMiroJWT(), // Provide token in async way success: data => { console.log("on success", data); document.querySelector("#test").innerHTML = data.embedHtml; }, error: e => { console.log("on error", e); }, cancel: () => { console.log("on cancel"); }, });getMiroJWT() returns a promise. And the windowRef works but it says “Sorry, integration is unavailable.” . The exact error message from the console log is“ on error Application key: **********. Reason is platformApplicationNotFound “ I could not find anything about platformApplicationNotFoun

1242
A
R
RamkumarBeginner
posted in Developer platform and APIs
Bug Report: Metadata update from current app overwrites another apps metadata

Hello,We have couple of web plugins that use metadata, When app#1 updates metadata it is stored in the below format{ "metadata":{ "appID#1":{ "data":[ 1, 2, 3 ] } }}Let say we are updating metadata from another app, then its getting stored by removing the app#1’s metadata.{ "metadata":{ "appID#2":{ "data":[ 10, 11, 12 ] } }}We couldn’t workaround the problem by supplying entire metadata(from both app’s), in which case below error appearsYou can write metadata only for your app Id ‘3323453453454….’

3283
Daniela Gavidia
Mironeer
K
KundanBeginner
asked in Developer platform and APIs
How to authenticate user (the host of meeting) through iframe, using web app credentials

Hi,We have implemented the board on our web app using iframe integration, but when a host wants to share the video or start video chat he/she needs to log in first through miro.com.We want to authenticate the user without going to miro.com, is there any way to set authentication through iframe or any API calls? Thanks in advance! regards,Kundan

3271
Boris Borodyansky
Mironeer
J
Jason BougasBeginner
posted in Developer platform and APIs
Create Wireframe from metadata using API

I was wondering whether I can create dynamic wireframes using metadata stored in a database?Has anyone done this?For example if I have a list of fields, data types and the order they should appear on a page could I render a dynamic wireframe?  So if I change the order of the fields it would update the wireframe.Ideally I would like to drag items on the wireframe and update my metadata as well or add new items and have the metadata update.I would also like to tag every field with a unique id that ties it back to my metadata.  This way I can track dependencies back from the wireframe to the metadata.

4311
Max Harper
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs
Height param in text node seems to be stuck at 36

I’m working on a Miro scaling app which also displays current dimensions to the user. the dimensions are represented by X & Y axis arrows + their values. For some reason the text “height” property which is responsible for the size of the font I believe, always gets reset to “36” even though I have cases when it should be larger (if a widget is bigger so that the text has better visibility) see attached pictures below:small widget with 36 text height works finebig widgets with size 400+ units need bigger textCurrently I have a simple sorting function which looks at the height / width of the widget and assigns a text height accordingly. At widget side of 60 units or less I’m assigning 36 text height, at 400 units or less I assign 56 text height, at 1200 or less I assign 76 text height, and at 1200+ units I assign 100 text height. The Problem: Text height always defaults to 36. When resizing by hand on miro board I am able to reach these text heights.  Alternatively there might be som

1571
Daniela Gavidia
Mironeer
O
Oleksandr StepanenkoNew Here
asked in Developer platform and APIs
Miro board for database modeling

Hello! My team uses miro board intensively for the different tasks and I have to say it’s awesome instrument! Some time ago we started using it for the database modeling. We use Shape widget to define tables and then we just put some text inside which describes columns of that table. The problem is that we would like to have a more strict tool for that than just shape widget. We’d like to have custom widget which might be a something like a table widget but just with three columns stands for column name, column type and description. Types of columns should be predefined and should be choose from dropdown list. Also it should be possible to connect tables using connection lines. Is something like this planning in the future?If no, could you please give a clue on how to implement this widget/plugin? Is there any example on how to implement such a widgets? Many thanks in advanced!

61181
Kiron Bondale
Terms & Conditions