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,351 Replies

710 Topics

T
Thomas LarssonBeginner
posted in Developer platform and APIs

Looking for a way to export Miro data (postit, frames, text) to Google Sheet

Export to CSV is quite poor and I cant sort from that data. I could go through API:s but I thought I ask first if anyone had done that?Small map that I use. 

3
T
2 years ago
M
mulinPNew Here
asked in Developer platform and APIs

Autoincreasing Team Size with API

Hello everybody, i send invitation via API to new member and get error with message: 'User limit exceeded'. It all because there is 0 seats remaining, but when sending invitation from browser, it allows to expand team seats.Is there any possible way to send invitation via API with auto-increasing team size?

1
Daniela Gavidia
Mironeer
2 years ago
Fredrik Wendt
Fredrik WendtContributor
posted in Developer platform and APIs

Lock & Hide Frames via REST API

We run workshops and trainings, usually with about 100 frames/exercises. For every class/workshop, these are copied from a template and there’s usually some manual tweaking to be done by the trainer. I set out to write a simple tool that would unlock & unhide all frames, let the trainer make some tweaks, and then run the tool again to lock (in place) and hide (to prevent peaking ahead) all frames.I was surprised that frames are readonly. Is there any workaround to this issue of having to click at least 200 times (lock, hide) to get ready to run a workshop?

3
N
1 year ago
Markus Smet
Markus SmetMiro Hero
asked in Developer platform and APIs

Is it possible to capture the CardID and Title props. of a Jira card in Miro?

Is it possible to capture properties of a Jira Card on a Miro board? I am wondering if the Jira card extends a Card Widget which means Jira Cards can be called via the SDK’s read method?

2
A
5 months ago
R
RamkumarBeginner
posted in Developer platform and APIs

Bug Report: Line widget style update impacts bounds/endPosition properties

Hi, When we update Line widgets style through web plugin API, it impacts the read-only bounds/endPosition properties. This cause line widget to switch to undesired position when connecting between 2 widgets. Video for this behaviorhttps://www.loom.com/share/dbadddf3261a49388a28803725f81fa5Notice that the line changes position after color change Before and after comparison of widget properties 

3
Esteban Beltran
Mironeer
2 years ago
N
niklaslavrellBeginner
asked in Developer platform and APIs

Force the iFrame embed widget to run inline directly the board

Hi Miro,Some iFrame embed widgets seems to run (when you press the play icon) inline directly on the board (e.g. Youtube & SoundCloud) and some run in the popup modal view (e.g. Spotify, Product Hunt). I’m building a web app (to run inside the iFrame embed widget) and a Miro web-plugin, how can I make the embed widget to run inline directly on the board? I can’t find any documentation or references in the SDK.Cheers,Niklas

8
L
2 months ago
J
Jesse HouwingBeginner
posted in Developer platform and APIs

Update internal board links after duplicate/import

We use a bunch of boards as templates and my colluagues have gone wild with links within a board.When I duplicate a board or when I import it as a backup, all of those links still point to the original board.I tried editing the backup file and making the link `?movetoWidget=283917482397498324`, whicn in theory should work, but the app prepends `http://` and claims the link is invalid.I tried the API, but many oobjects that can contain links can't be updated. Even ones that are documented, like `shape`.My code: $goodboardId = "o9J_xxxxx"$badBoardId = "o9J_yyyyy"$goodBoard = "https://miro.com/app/board/o9J_xxxxx#61;"$badboard = "https://miro.com/app/board/o9J_yyyyyyy="$boardUri = "https://api.miro.com/v1/boards/$goodboardId"$headers = @{ Authorization  = 'Bearer XXXXXXX'}$supportedTypes = @("Sticker", "Shape", "Text", "Line", "Card")$widgets = Invoke-RestMethod -Uri "$boardUri/widgets/" -Method GET -Headers $headers$widgets.data | ?{ $_.text } | %{    $originalText = $_.text    

6
J
2 years ago
Markus Smet
Markus SmetMiro Hero
posted in Developer platform and APIs

My experience of developing a Miro app

We have just finished a plugin for Miro that allows a user to “syncronise” widget content. Change one widget in a sync group and the change is propagated across all widgets in that group. The app is called CarbonCopy and we hope to see it on the Marketplace soon. Here’s a loom for you to get a preview.Here’s a summary of our encountered challenges.identified workarounds and challenges in MiroMissing widget update capabilities when widget changes: https://community.miro.com/developer-platform-forum-57/identify-changes-in-miro-widget-2845 Image meta-data updates aren’t working, which means we were unable to implement image widgets: https://community.miro.com/developer-platform-forum-57/image-widget-doesn-t-allow-metadata-update-2894 Buttons in the WidgetContextMenu iframe implementation cause slightly laggy widget performance when the widget has a plugin button in the widget’s extension menu. Setting the button position in the WidgetContextMenu is based on setting a numerical priority wh

11
Max Harper
2 years ago
S
Savannah wexlerNew Here
asked in Developer platform and APIs

List Randomizer

Hi, I am wondering if anyone has any ideas on how to create a randomizer that would take a list of items or names and randomly select one. I currently am using the random number generator and associating it with a name but would like to have it automatically do this, as I am using it for a game I have built and I have to do this multiple times and it gets confusing for students.

25
K
2 months ago
Sami Ljimari
Sami LjimariActive Contributor
posted 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?

4
Sami Ljimari
2 years ago
Clyde D'Souza
Clyde D'SouzaGroup Leader
posted in Developer platform and APIs

Elevator music app for all users - Dev help required

Hi!It’s my first time trying to make a Miro app and was thinking of making an elevator music app. I’m thinking - a user can click the “play audio” button and this music plays for everyone who is active on the board. The use case is - during collaboration meetings, there are many occasions when individuals have to work independently for a few minutes before regrouping. During this silent time, it would be nice to have some sort of music played for everyone in the room. I got to the point where I can get the user to play a music, but unfortunately, it only plays for that user and not other users. Does anyone know how to make this a reality?Thanks!

4
Clyde D'Souza
2 years ago
M
mxvrhubNew Here
posted in Developer platform and APIs

SOS! I lost access to the board I was developing. Free trial.

I would like to report a problem with access to the board I was using/developing.Somehow, the owner of the board is someone I don’t know. I don’t know that person and I don’t understand how it’s possible, that my content is not under my name. It’s a mess.Probably, this person had an empty board and I started creating my mind map there… I did not realize that was not the way to do it. I still don’t understand what just happened. I NEVER chose or agreed to follow the other boards either. I have no idea how and why they appeared on my list/dashboard. I have been trying to leave them, but there’s no such option. I want to leave all the boards except for one — that I have been working on for months. I currently technically cannot execute an upgrade for my account and I depend on the information that I have on my board. PLEASE, HELP! ASAP  Thank you!

3
mlanders
2 years ago
N
niklaslavrellBeginner
asked in Developer platform and APIs

Play embed widget with the SDK?

Hi Miro,It is possible to play (i.e. click the play icon) the embed widget pragmatically with the web-plugin JS SDK? If no, it would be a wish list feature for me 😊Cheers,Niklas

1
farbodsaraf
Mironeer
2 years ago
E
Equator BytesBeginner
asked in Developer platform and APIs

Image widget doesn't allow metadata update

As per the documentation Image widgets metadata is not specified to be Read-only, but the miro.board.widgets.update method doesn’t update the metadata. At the same time it does allow the Title/URL properties to be updated.Documentation: https://developers.miro.com/docs/interface-iimagewidgetIs this a limitation of Image widget or is it a bug?

1
Daniela Gavidia
Mironeer
2 years ago
U
Uday CherukuriNew Here
asked in Developer platform and APIs

Using REST API to create Widgets, can they be attached to existing widget context?

For some context, I’m looking to connect another one of our applications to Miro to populate a Kanboard with Project data. I’m accomplishing the creation and description portion of this idea programatically, but needing to put the idea into the correct swimlane that indicates each individual projects progress manually. Also unable to add tags programatically which contains project tag data.  I’m wondering if the kanban board will ever get support to add cards to an existing kanboard via api, and also interested in when adding tags to cards will be a supported feature. 

2
A
2 years ago
M
Maximo ZarzaNew Here
asked in Developer platform and APIs

Embed board into own site authenticating by access token

Hi!I’m trying to embed Miro’s board into our platform but we need to abstract about Miro’s session for each user.It’s posible to manage access tokens for team’s users from API and then embed the board by param, so the user has not to login into Miro manually before render the protected board within iframe. Thanks in advance.

1
Boris Borodyansky
Mironeer
2 years ago
E
Equator BytesBeginner
posted in Developer platform and APIs

Identify changes in Miro Widget

Hello,We would like to identify when an widgets(text/image) is updated and based on that we want to perform some actions. Currently there is no event type to indicate if the widget is being updated (We are not interested in WIDGETS_TRANSFORMATION_UPDATED which fires the position/size changes)Supported EventType: "SELECTION_UPDATED" | "WIDGETS_CREATED" | "WIDGETS_DELETED" | "WIDGETS_TRANSFORMATION_UPDATED" | "ESC_PRESSED" | "ALL_WIDGETS_LOADED" | "COMMENT_CREATED" | "CANVAS_CLICKED" | "DATA_BROADCASTED" | "RUNTIME_STATE_UPDATED" | "METADATA_CHANGED" | "ONLINE_USERS_CHANGED"As a workaround we thought we could use the SELECTION_UPDATED event to trigger the action after widget updated but then there is no modified timestamp against the widget to detect if any changes happened. Is there any workaround or hack to approach this problem?

1
Kenneth Chen
2 years ago
J
Jason LarkinBeginner
posted in Developer platform and APIs

Export Board Metadata, Natural Language, Tags, etc

I am trying to better analyze a very complex board formed from the:https://wiki.p2pfoundation.net/Main_PageBecause of it’s complexity I was hoping to access its objects from this python client (which wraps around the REST API)https://github.com/jasonlarkin/miro-python-client/blob/develop/gameb.ipynbhttps://github.com/jasonlarkin/miro-python-client/blob/develop/miro/client.pyI noticed this topic came up recently:https://community.miro.com/got-a-question-ask-the-community-45/export-pictures-and-full-board-from-miro-2258I don’t necessarily need to export pictures, just the natural language associated with any metadata would be helpful.  As of now this metadata is missing (see gameb.ipynb) Having this metadata could enable semantic analysis of the board which could compliment the same analysis on this wiki which was used to seed the board:https://wiki.p2pfoundation.net/Main_PageMy plan is to perform analysis in this vein:https://www.mdpi.com/1999-5903/8/2/14/htmand publish the results. Gra

8
T
2 years ago
N
NewBeginner
asked in Developer platform and APIs

API Miro for your personal board.

Hello! I was versed in the API by following this documentation:I was able to build my development team and my floating decal board. However, I noticed that you cannot go to your main profile (which I work on) and connect the API to it. In the settings of your profile, when creating your application, you can select only the team profile, but you cannot choose your own.What does it mean? Can't I use the API on my board?

1
Daniela Gavidia
Mironeer
2 years ago
Blake Cottington
Blake CottingtonBeginner
asked in Developer platform and APIs

User and Team Management via API

Hi Miro Developer Community. Question - it seems like there is no way to do these things using the API:List all users in the company, and their license level List all teams in the company Create a new teamIs that right? I saw another post saying that you can use Get Team User Connection to list team members and their role. But that’s just for one team. Is there another method for doing this? Or is there a plan to offer this in the API? Doing these things manually is real pain if your company has hundreds of users or hundreds of teams.  Thank you in advance!

15
Geoffrey Lee
1 year ago
N
NewBeginner
asked in Developer platform and APIs

Move an object up or down in layers - API

Forgive me if something is not entirely clear, I am a Russian-speaking user.I want to know how can I implement a method to move an object up or down in layers?It's quite easy to do it on the board - just select an object, press the ellipsis - brintg to front or Sent to back.How can this be done through the API?Unfortunately I am not at all familiar with API Miro, but I have experience in this area, so I think I can get an authentication token and connect to my board. What's next?Can you provide links to the required documentation? (I work in Python)Thanks.

1
Daniela Gavidia
Mironeer
2 years ago
Sami Ljimari
Sami LjimariActive Contributor
asked in Developer platform and APIs

de-select widgets

Hi I was looking for a solution to de-select currently selected widgets on the whiteboard here https://developers.miro.com/docs/interface-iboardwidgetscommands but couldn’t find a solution. I’m using a widget attribute of clientVisible: false . After I overwrtite a widget with this attribute it becomes invisible on the whiteboard but still can be manipulated with as it stays selected hence even while in clientVisible : false state the user is able to move it around, I would like to perform a de-select method after the clientVisible change, so that the user would either have to make the widget visible again to move it around or not be able to move it while it is invisible

2
Sami Ljimari
2 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 <iframe [src]='https://miro.com/app/board/o9J_ldxFWKw=/'></iframe> 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.

3
L
1 year ago
B
Ben MortBeginner
posted in Developer platform and APIs

Why do updates though the REST API trigger a "connection restored" message when viewing the board in a browser?

I am in the process of updating and testing an app which updates boards though the REST API. While doing this I’ve noticed a change in behaviour from the last time this app was used. Making a call to the ‘update widget’ (https://developers.miro.com/reference#update-board-widgets) endpoint results in a “connection restored” pop-up in a browser watching the board being updated. This behaviour is also reproduced using the ‘Try-it’ button in the API documentation, and has been seen with both Firefox and Chrome.This is a issue as it results in the board becoming temporarily unresponsive. This change appears to have happened in the last 3 months as it was working well the last time the app in question was tested.Any help or advice on how to fix or work around this behaviour would be greatly appreciated.If you would like more details please let me know.

2
B
2 years ago
J
jrgarlickNew Here
asked in Developer platform and APIs

Error trying to create Development Team

I am working for a larger organization which has Domain SSO enabled for their users. We are working on building a custom app for Miro, but when I follow the instructions on the Getting Started page, and click the Get Dev Team to Create an App, I get an error that says: “Domain users are not allowed to create any accounts outside of their domain organization.” We have been building the tool in our own development project, but it’s now time to hand it over to the company and I don’t see how to add it in their organization’s settings. Our ‘API, SDK & Embed’ tab looks very different from theirs.Any help would be greatly appreciated.

1
Robert Johnson
2 years ago
Terms & Conditions