Developer platform and APIs

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

  • 710 Topics
  • 2,350 Replies

710 Topics

E
Evans WangNew Here
posted in Developer platform and APIs

Hand-writing experience improvement (benchmarking to Microsoft Whiteboard)

When I use the handwriting pen of laptop on the screen, I found the writing experience in Microsoft White Board is better than that performing in Miro Board, suggested to improve on this : )Below 2 pictures for comparison:(It is more difficult to control my hand force to keep a good shape of writing in Miro Board. The line thickness is varying from different writing force in White Board, while Miro has not.)

0
E
2 hours ago
S
Simon BergeronNew Here
posted in Developer platform and APIs

Miro boards API pagination does not seem accurate

Hello, we are trying to extract boards data form the boards API. We are using the limit + offset pagination, but are seeing discrepencies with the number of records returned by each call.We set the limit to 50, but the number of rows returned can be lower than 50. Sometimes 47 or 42. To be clear, this is not the last page of the offset, so the number of records should be 50. Is this a bug on the API pagination?Thanks for your help,Simon

0
S
21 hours ago
A
Abhinav GuptaNew Here
posted in Developer platform and APIs

Custom shape widge as an app

Hi Guys I have a use case to create a custom shape widget on the Miro board where in a user can add one or more widget [ lets call it a card ]. Inside each card - I want to add some information in each tab and I can add or delete tabs ( rows ) as per the requirements. Widget should allow editing the information in each block.  Please visit this link to have a visual idea about the image - https://i.ibb.co/r6ssh6k/custom-widget.png I need your suggestions - How can I create this and use it on the development canvas board?  ThanksAbhinav 

1
Josip Janzic
Mironeer
1 day ago
Alexander Akhtyrtsev
Alexander AkhtyrtsevBeginner
posted in Developer platform and APIs

Boards picker for unregistered users "This board is private" issue.

Hello there,Having a problem with embedding Miro inside another iframe.It says “This is a private board”.I’ve submited the form to get access to boards picker component according to documentation.Here is the code:miroBoardsPicker.open({ clientId: clientId, action: 'access-link', allowCreateAnonymousBoards: true, getToken: async () => axios.post('/obtain-jwt').then(r => r.data), error: e => { console.log('on error', e) }, cancel: () => { console.log('on cancel') }, success: async function (result) { console.log(result) window.open(result.accessLink) }, }) It works well upon opening the access link in the separate window via window.open()Access Link example: https://miro.com/app/live-embed/uXjVMBMXOW0=/?boardAccessToken=5GDDy0S9quNzU4zH3U4jtsktWiJbpgKV&autoplay=trueHowever inside iframe some XHR requests falling with 403 error.​​​​​I noticed, that i

7
Alexander Akhtyrtsev
22 hours ago
U
Unleash QA1New Here
posted in Developer platform and APIs

An error occured while retrieving the subscription. Contact support to request assistance.

Hello community!I found a strange error going through logs, which is not reproducible so easily. The error message is “An error occurred while retrieving the subscription. Contact support to request assistance”, status is 400 and the code is “7.0913”.Does this happen to anyone and can any information be provided in order to understand the error ?Thanks in advance

2
U
1 day ago
S
Steffen BeckerNew Here
posted in Developer platform and APIs

Jira Cards (DC) with OAuth 2.0

Hello,I struggle to install Jira Cards with our onprem Jira instance (DataCenter) using OAuth 2.0.What I read from Miro documentation is that OAuth 1.0 is used for onprem Jira instances.In the german version it is even said that:The protocol used is OAuth 1.0.Currently Atlassian only supports this protocol. OAuth 2.0 authorisation code (3LO) is currently in developer preview.https://help.miro.com/hc/de/articles/360013463739-Jira-Karten-FAQWhich is clearly untrue because our Jira instances (v9.x) uses OAuth 2.0 by default.That’s why the connection between Jira and Miro does not work for our instance, because Miro only supports OAuth 1.0. So my question is: How can I connect Miro to Jira (DC) - while Miro only supports OAuth 1.0 but Jira only supports OAuth 2.0?

0
S
3 days ago
Will Bishop
Mironeer
Will BishopMironeer
posted in Developer platform and APIs

Developer Challenge: Where's Miro? Scavenger Hunt!

 Introducing our new Developer Challenge Hey, devs! Ready for a challenge?Check out the Miro Developer Platform's Web SDK Scavenger Hunt 🔎Level up and use Miro's Web SDK to interact with your boards, using just our built-in console. 🤖Get Started and earn a surprise developer badge:https://bit.ly/43dwkni

0
Will Bishop
Mironeer
8 days ago
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs

Miro REST API introduces flowchart shapes

Good day Miro developers! 🖖 😃 In our endeavor to extend our features and functionalities, the experimental release of shapes now supports flowchart shapes in addition to the basic shapes that we support in production. This experimental release supports read operations for flowchart shapes via the following APIs:Get shape item (experimental) Get items on board (experimental) Get specific item on board (experimental)For more information, see the changelog. Cheers,Mira

0
Mira Balani
Mironeer
14 days ago
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs

The Miro Web SDK 2.0 introduces mind maps

Good day Miro developers! 😃 We have some good news to share! The Miro Web SDK 2.0 introduces mind maps in its experimental release today. Create, read, update, or delete mind maps to programmatically represent and interact with complex structures of information into Miro boards. With minimal development effort, you can also seamlessly import and export from third-party tools, or transform mind map information into other item types in Miro.For more information, do check out the following resources:Mind maps change log Mind maps overview Mind maps reference guide How-to guide on creating a mind map from a CSV fileHave fun trying it out! Cheers,Mira  

0
Mira Balani
Mironeer
14 days ago
N
NataliMaRisNew Here
posted in Developer platform and APIs

The app panel does not appear to the other users of my team when I am collaborating in real time with them.

When several users are in the same board, they not see the left-side panel where the app is running. They can use the app independently, but it does not show them what the administrator is doing at the moment in his panel.For example, if I'm inserting a word into wordle app , they don't see the word that i am writting ,and they can´t insert a word. But if i add a sticky note they inmediately see it on the board and they can edit it.administrator :member:In the screenshot , both users are at the same time in the same board. Both see the board, but only one the panel app.The panel where the app that I have developed is running does not allow me to share it in real time with the other team members. My question is: is there any possibility that the panel where the app is running can be shared just like the board is shared?

1
Will Bishop
Mironeer
14 days ago
D
Dmytro KoziuberdaBeginner
posted in Developer platform and APIs

Bug related to Items endpoint

Hi all, I found such a pattern, which in my opinion is a bug, unless of course it is caused by the impossibility of development.Main: uploaded on the board item's "title" does not appear in the response until it is edited.Steps to reproduce:1) I create a board and with the help of "Drag & Drop" I throw several png files with predefined names onto it. For example, "Test_Image_1.png", "Test_Image_2.png", etc. (I think it works with other file types too, but I haven't checked)2) I make a request to extract all Items. For example, 'https://api.miro.com/v2/boards/<board_id>/items?limit=50' or 'https://api.miro.com/v2/boards/<board_id>/items?limit =50&type=image'3) I get the result with the correct number of elements, but in "data" the elements have only "imageUrl" and no "title", although it is there.Example:{..."createdBy" : {       "id" : "item_id",       "type" : "user"     },"data" : {       "imageUrl" : "https://api.miro.com/v2/boards/.....",   },....}4) If I someho

7
D
1 day ago
M
Manjunatha CitragarNew Here
posted in Developer platform and APIs

Live Embed Miro Board Events

Hi Team,        Is there a way to capture user interactions with Live embed Miro board? I want to  capture the those events and replay them later re-creating entire interaction with the board programmatically.  Thank you

1
Will Bishop
Mironeer
17 days ago
P
pholzNew Here
posted in Developer platform and APIs

How to change the order of the presentation frames using Web SDK?

I use an async call to create a number of frames with `createFrame()`. When I go into “Presentation Mode” in the UI, the order seems random (or influenced by the async call). Using the UI sidebar, I can of course change the order. How can I do this programmatically? Is there a property such as `presentationOrder` for frames?

1
Mira Balani
Mironeer
21 days ago
L
LeonardoNew Here
posted in Developer platform and APIs

TypeError: board.createStickyNoteItem is not a function

Hey everyone, I’m following thishttps://developers.miro.com/docs/working-with-sticky-notes-and-tags-with-the-rest-api and after obtaining my oath for my app and plug that in the code, plus added the board id from https://miro.com/app/board/uXjXXXXXXXX/ where uXjXXXXXXXX(censored) is the board id and i get the following error:‘const sticky = await board.createStickyNoteItem({                           ^TypeError: board.createStickyNoteItem is not a function‘Complete code: // Using miro-api client libraryconst { MiroApi, ShapeItem } = require("@mirohq/miro-api");const api = new MiroApi('eyJtaXJvLm9yaWdpXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX')const board = api.getBoard('uXjXXXXXXXX')async function main() {const sticky = await board.createStickyNoteItem({ data: { content: "I'm a sticky note", shape: "square", }, style: { fillColor: "light_yellow", textAlign: "center", textAlignVertical: "top", }, position: { x: 0, y: 0, },})}main()  I think the issue is wit

2
Mira Balani
Mironeer
17 days 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
23 days 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
26 days 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
27 days 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
28 days 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
27 days 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
30 days 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
30 days ago
S
SiegmarBeginner
posted in Developer platform and APIs

Call an external API from Web SDK

Hi,I am testing Miro REST API and WEB SDK and, so far, everything is woring fine.My current test is calling an external API from WEB SDK App, but it is not working.Is the ( API call ) code below valid for Miro ?It works perfectly well in a normal React site.As you can see in the code this example uses a non-authenticated and CORS enabled URI.Thanksimport * as React from 'react';import {createRoot} from 'react-dom/client';import { useState, useEffect } from 'react'; // APIasync function addSticky() { const [data, setData] = useState(null); useEffect(() => { fetch("https://contabo.easylob.com:5443/echo?origin=Miro") .then(response => response.json()) .then(json => setData(json)) .catch(error => console.error(error)); }, []); const stickyNote = await miro.board.createStickyNote({ content: 'Hello, World!', }); await miro.board.viewport.zoomTo(stickyNote);}const App = () => { React.useEffect(() => { addSticky(); }, []); return ( ... );}

8
Mira Balani
Mironeer
22 days ago
Christophe GESCHÉ
Christophe GESCHÉExperienced Community Member
posted in Developer platform and APIs

why did you choose such a complicated paging operation ?

 I understand the need to force a pagination (although 100; it's still a bit low.)But then the stroke of the cursor, I do not understand.Could a simple "offset" have been suitable?Limit=100&offset=0, Limit=100&offset=100, Limit=100&offset=200, … In any case, it complicates my work terribly.Maybe making access difficult and complicated is a way to reduce the load on api servers.

10
Mira Balani
Mironeer
21 days 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
1 month 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
1 month ago
Terms & Conditions