Developer platform and APIs

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

  • 798 Topics
  • 2,592 Replies

798 Topics

R
richardwBeginner
posted in Developer platform and APIs

User's LastActivity datetime from API

Hi,   Is it possible to get a member or non-team member’s LastActivity datetime from the API?   If not is it one the roadmap and is there a scheduled release date?   many thanks

11
H
10 months ago
M
MelanieNew Here
asked in Developer platform and APIs

Problem with content blocked error/ warning when trying to run a web plugins example

Dear Miro dev Community,   I’m trying to run the ‘Stickers and Shapes’ web plugin example code in my Sandbox running a ngrok server locally. Although the SDK loads and the plugin in being initialised, I’m getting the following error/ warning: [blocked] The page at about:blank was not allowed to display insecure content from http://11d1b29e.ngrok.io/<file path> (see screen grab below). I’m using Safari on a Mac.   I’d really appreciate if you could provide some advice.    Many thanks!  

5
P
2 years ago
Sami Ljimari
Sami LjimariActive Contributor
posted in Developer platform and APIs

Get miro board object

Hi, I would like to get a Object of the whole, complete miro board. Found this article in documentation: https://developers.miro.com/reference#get-board  But it doesn’t include any miro board command that can be used like with board widgets for instance which have something like this: miro.board.widgets.get()tried miro.board.get() but the feedback I get from console is that it is not a supported function, so the question would be if there is any integrated way of getting the whole board as an JSON object for the sake of “replicating” / “duplicating” the board contents on a new board for instance. Also, how should I go on about getting custom board objects like images to get them on a new board since I would like to get the exact copy of a already existing board which may include .jpg (or similar) files on it. Alternatively is there a different / better way to do a task like this? Thanks for any suggestions

2
Sami Ljimari
3 years ago
C
CSABeginner
asked in Developer platform and APIs

Edit web-plugin after install

I’m new to creating plugin for Miro. I have created a test plugin by follwing https://developers.miro.com/docs/how-to-start this & successfully added to my board. But how to modify/change my plugin after installation. When I change the code in index.js file of my web page which is hosted in the web plugin url, the plugin does not affect. It keeps un changed. How to update my plugin to affect changes.Thank you

6
Robert Johnson
3 years ago
S
Sathiamoorthy MBeginner
posted in Developer platform and APIs

Export board Image or PDF using API

Hi,How to export the miro board as Image, Pdf or any other format. Someone could please help me out, I need this feature.Regards,Sathia

12
William Bishop
Mironeer
5 months ago
A
Addison JosephBeginner
posted in Developer platform and APIs

Create Widget: PostMan POST Call with Auth works. Fetch API Post call gets CORS error

Hello! I am able to provide my auth bearer token to a POST request containing the json to create a widget on my board via PostMan or the live test in the API Documentation.  However, running a local server / react app to call the fetch api using the same url and http headers/credentials results in CORS error. How am I to test the rest api for my app using the fetch api and running on localhost:XXXX?

9
A
2 years ago
C
Carmen GraverBeginner
asked in Developer platform and APIs

Can't Update Cards

I’ve recently run into problems updating cards on my boards.  Unable to move cards or to update them unless I close Miro and then reopen.  

5
Kiron Bondale
3 years ago
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs

Is there a miro board command to gather all widgets?

What is the best way to get a list of all widgets on miro whiteboard. I would want something like “miro.board.widgets.get.all”. Used this for reference https://developers.miro.com/reference#get-board-widgets-1 Edit: deleted the original question, this ^ was pretty much it 

5
V
Mironeer
3 years ago
Steve Appling
Steve ApplingBeginner
asked in Developer platform and APIs

Trouble using app outside of developer team

I’ve created an app and tested it in my dev team.  Now I want to use it on my real team with other users.  From step one here, it looks like I should be able to use the “Install app and get OAuth Token” button to get an accessToken.  While I was able to get one that works on the board in my dev team, it doesn’t seem to work for boards in my real team.  If I go to the “API, SDK & Embed” tab of my profile, I see my test app listed associated with a team of “Dev team”.   I can’t seem to edit this to associate it with another team.  If I try to create a new app, it only lets me pick the Dev team. How can I use this app I created with a real team?  It’s a command line tool, so I don’t think I can participate in an OAuth flow.  It’s not running from a web site.

1
Boris Borodyansky
Mironeer
3 years ago
E
EgorNew Here
asked in Developer platform and APIs

Undo working result of the plugin

Hello! I am plugin developer and i want to do feature which allows user undo working result of my plugin, i can do this in entries of my plugin but will be cool if i integrate this into miro undo\redo functionality, so can i achieve this or this is impossible?  

1
S
Mironeer
3 years ago
tkat0
tkat0New Here
asked in Developer platform and APIs

Unable to get CARD metadata with REST API

Hi community. I want to develop an application that use card metadata.Unfortunately, I can add metadata to the card with JavaScript SDK, but I can’t get it with REST API.Do you know why? Reproduction procedure(0) Create Applicationhttps://developers.miro.com/docs/getting-started(1) Create a card with SDKawait miro.board.widgets.create({ type: "card", text: "test card", metadata: { [appId]: { hoge: true, }, }})(2) Get the card with REST APIcurl --request GET \ --url https://api.miro.com/v1/boards/${board_id}/widgets/${widget_id}\ --header 'authorization: Bearer ${token}'→ No metadata Thank you.

1
Daniela Gavidia
Mironeer
3 years ago
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
6 months ago
mlanders
mlandersExperienced Community Member
asked in Developer platform and APIs

Error in sticky notes

I have noticed something strange: I created a Sticky Note and wanted to wrap the words into two lines. As I clicked enter it shows me this: I have seen this only one time before but I cannot remember how I could reproduce it. Any solution? Michael

3
mlanders
3 years ago
M
Mike HatchBeginner
asked in Developer platform and APIs

Using clipboard from web-plugin

I’m trying to create a web-plugin component that uses a library component (miro.board.ui.openLibrary) that tries to capture events (change or paste) events so the user can paste data into the component.  In the event, I am trying to access navigator.clipboard.readText().  It fails on this line with the following error in chrome: Uncaught (in promise) DOMException: Disabled in this document by Feature Policy.It would seem that access to the clipboard is not allowed within a web-plugin? If it is allowed, is there something specific I need to do to enable it?

3
M
3 years ago
Lena Shenkarenko
Lena ShenkarenkoExperienced Community Member
posted in Developer platform and APIs

Miro Hackathon – what would you build?

Internal hackathons are huge for Miro product culture. We organize them twice a year for two days and last month 20 teams were competing for the main prize for the 7th time in history. I just wanted to share some pictures from this internal event and give a sneak peek into the projects teams were working on.   For example, one of the teams called ‘Dotmocracy’ created a platform app for voting with a predefined amount of dots per user. Other projects include enhanced board history, plugin that allows to automate routine tasks on the board, and even custom Miro Instagram masks and stickers. I’m curious – if you were to participate in Miro Hackathon, what would you build? 

0
Lena Shenkarenko
3 years ago
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

3
T
2 years ago
S
saifisBeginner
asked in Developer platform and APIs

Is there a way to set the "z-index" equivalent when creating objects with the api?

I’m making objects and some of them go under some objects that I want to be in the background, is there a way to set the, in CSS terms z-index, putting some objects “backwards?”

1
Max Harper
3 years ago
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs

Get user id

Hi,I have tried a few ways to get the current user id, but I always encounter a error in one way or another. What is the most basic way to get a user id? So far I have mainly tried this: async function getUser() {        const proxyurl = "https://cors-anywhere.herokuapp.com/" // getting cors error without this        const url = "https://api.miro.com/v1/users/me"         const options = {            "method": "GET",            "headers": {                “Authorization”: `Bearer ${token}`,                "Content-Type": "application/json"            }        }         fetch(proxyurl + url, options)        .then(response => {        console.log(response)        })        .catch(err => {        console.error(err)        })    }I’m currently getting error 401 “Not Authorized”I’ve seen a few discussions in here about a direct miro dot command that can get the user id but can’t find it anywhere in the documentation. Will be thankful for any suggestions as I ran out of ideas of what to

2
Sami Ljimari
3 years ago
M
Markus EdenhauserBeginner
asked in Developer platform and APIs

How to link nodes programmatically?

Hello!Using the miro javascript sdk, I have built a plugin to create shape groups based on a given input. Now I would also like to create the links between shapes programmatically. Take a look at the picture below, please.The links were created manually to show what is the intended result. Since I have reference to the widgets it should somehow be possible to create links between them. But I did not find a corresponding method. Ideas how to achieve that?Thanks, Markus

4
B
1 year ago
T
TarangContributor
posted in Developer platform and APIs

Creating Templates with Inheritance of Locked attributes of Components

I have created Miro boards that I expect to use in a number of events and so I export the board as a template so I can source it to instantiate my board for other events.The problem is that all the locked attributes for components in the original source are not preserved in the Template and its tedious to have to reassert the locks every time. I was expecting export as template will preserve all attributes in the template, this includes lock attribute. Why isn’t this the case?

3
Max Harper
2 years ago
C
Craig HardcastleBeginner
posted in Developer platform and APIs

Plugin widget.create() promise never complete

Hi, I seem to be having an issue in getting the miro.board.widgets.create() promise to complete. The widgets are created but the returned promise never changes from “pending”. I have tried creating widgets one at a time and in batches but with no luck. As I say the widgets do create but without the promise completing or even erroring there is no way for my code to complete… it just hangs forever :( Anyone else has this issue? My code block is wrapped in the miro.onReady() callback so I don’t think i need to do anything else? Thanks.

6
Daniela Gavidia
Mironeer
3 years ago
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs

How to correctly use bringForward() and sendBackward() Miro board functions

Hi, I’m trying to use bringForward() and sendBackward() Miro board functions which I found here: https://github.com/miroapp/app-examples/blob/master/miro.d.ts (line 351 - 357) I assumed this only needs the widget id’s in an array but when I tried with some test data it doesn’t actually change the widget “priority” AKA doesn’t send them forward or backwards. Tried something like this: `sendbackward(arrayOfWidgets)` where arrayOFWidgets were a few selected widgets from current boardIs there a specific use case that has to be done like with miro.board.commands , where they have to be in a miro on ready block? Or am I missing something else?  Thanks for any suggestions

2
Sami Ljimari
3 years ago
P
Phil WolffBeginner
posted in Developer platform and APIs

If This Then Miro. Deeper Density. and Vasting Up.

Right now Miro seems mostly about people starting things. I’m sure Miro has a frequency distribution showing how many boards people make. Over time, how many times they come back, factors driving repeat usage, tipping point between trying a few boards and being hooked on Miro, factors driving sharing and collaboration. IFTTM. I want to know about scale and how miro will help with scale. With APIs, other tools can generate boards. Like the manager who had more than a thousand pdfs for his team to annotate. People who meet could connect miro to calendaring and conferencing apps to trigger templated boards and automatically invite the right folks to contribute. Software developers might have a project’s issues not just added to a an existing kanban but start a scorecard board for each issue for a team to weigh in. There might be thousands of boards per worker, most generated automatically to lay the ground for further work.  Overwhelm ahead. But nothing in the user experience suggests any

4
Sita Magnuson
2 years ago
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

2
Iraklis Alexopoulos
2 years ago
M
MarkNew Here
asked in Developer platform and APIs

Simple plugin no longer working. XML Parsing Error: prefix not bound to a namespace?

Hi, I had a simple plugin up and running that executed a function when I clicked a new icon in the bottomBar. I used some of the example code to get up it set up and everything worked ok. Now the icon no longer appears in the bar. The browser tools show that there is an error message (before the plugin is loaded though) that says: XML Parsing Error: prefix not bound to a namespace. I am not sure if this error message is new or not. Has something changed that means the the button-display code needs to change? The relevant plugin code is: miro.onReady(() => { miro.initialize({ extensionPoints: { bottomBar: { title: 'Post-it Counter', svgIcon: '<circle cx="12" cy="12" r="9" fill="none" fill-rule="evenodd" stroke="currentColor" stroke-width="2"/>', onClick: async () => {...} updateCount(); } } })})

2
M
3 years ago
Terms & Conditions