Skip to main content

News & Announcements
Events
Wish List

Ask a question
Login

Home
Community overview
Questions & Ideas
Developer platform and APIs

Developer platform and APIs

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

1,439 Topics
3,757 Replies

1439 Topics

Laszlo TorokNew Here

Developer platform and APIs

Include Miro boards of an organisation in federated full-text search

Hi,we have a fairly large organisation and we create content on multiple platforms (Confluence, Github, GDrive, Miro). We are currently building a federated search application to allow our employees to search across all relevant content repositories.We currently index content on Github, Confluence and would like to add content in our Miro org to our index. Is there some sort of API Miro offers to allow external search indexing bots to index their content, or perhaps something more specific to Elasticsearch, since it is the technology we happen to use?

Ronny RoellerBeginner

Developer platform and APIs

OAuth endpoint returns expired access token

For our app (3074457347393893408; status “Draft”), we go through the OAuth flow, and receive an access token.Yet, the token is expired: “expires_at” is the current timestamp and “expires_in” is set to 0. We also don’t receive a refresh_token.Interestingly, the option “Expire user authorization token” is deactivated in the admin UI.Do you have any advice what might cause this?

noam.arbelNew Here

Developer platform and APIs

Be able to show/hide shapes

Hello,I would like to have a way to hide and show shapes. This will allow to write an app for something like layering. I tried moving a shape into x=Number.maxNumber, which was good, as it was off the visible board, but then I get an error when I try to set it X value back to its original value. Something like it has no parent.Any other ideas on how to do this? Thanks.

Richard Watts-SealeNew Here

Developer platform and APIs

Export table data through the API

Is it possible to export table data, including the contents of each cell, using either the web SDK or REST API? I can see it is possible through the UI but I can’t figure out a way to do it programmatically.I can get back a list of all the widgets but there’s no explicit information about which cell they belong to. I guess it may be possible to calculate which cell each widget belongs to by using the table’s bounds and the widget’s co-ordinates but I haven’t looked into that yet. To give an example I would like to be able to programmatically determine that the “Whiskers” sticky belongs to the “Cats” column and “Names” row.

Trevor FoxNew Here

Developer platform and APIs

Can't upload file using SDK

I used the app SDK quickstart to make an app. Up until an hour ago, it was working. Then the file input stopped working. I haven’t touched this part of the code (to my knowledge) and the file select input event handler is not triggering at all. I have the following code:app.jsdocument.getElementById('csvFileInput').addEventListener('change', handleFileSelect, false);function handleFileSelect(event) { console.log('file'); const file = event.target.files[0]; if (file) { const reader = new FileReader(); reader.onload = function(e) { const contents = e.target.result; const rowsArr = processCSV(contents); buildGraph(rowsArr); }; }}...app.html<!DOCTYPE html><html lang="en"> <head> <meta charset="utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <script src="https://miro.com/app/static/sdk/v2/miro.js"></script> <title>My App</title> </head&g

Sami LjimariActive Contributor

Developer platform and APIs

How to group board widgets with Javascript with method

While browsing the Miro documentation I found some information about widget grouping: https://developers.miro.com/docs/interface-igroup This was sort of helpful, it shows me the parameters that are needed for a widget group but it doesn’t include a method which can be called to create a widget group. There is a GET method to get a widget group but I can’t find any further documentation on widget grouping, are there any other resources in the documentation?

saifisBeginner

Developer platform and APIs

Is there a way to make objects into groups via SDK?

I currently am making an app that has cards that you can move around inside the board, and just want one SVG image of the card and have text that I can change since the messages can be changed from time to time, and making hundreds of SVG images with different text is not exactly ideal. So I want to be able to create and image object and group it up with text, so I can drag the card around and have both image and text intact.

EladBeginner

Developer platform and APIs

Custom action query for exactly two elements

Dear Miro team, [Reposting https://community.miro.com/ask-the-community-45/custom-action-query-for-exactly-two-elements-15250?tid=15250&fid=45]I wanted to ask if it is possible to create a custom action for an exact number of elements, e.g. when exactly two frames are selected. Currently if I’m specifying ‘multi’ the action is also shown when a single element is selected, or more than 2. Thank you!

William BishopMironeer

Developer platform and APIs

NEW: Stable release of group and ungroup methods in Web SDK

Hey everyone!We're excited to share that we've released two new methods in the Web SDK which can be used to group and ungroup items programmatically. With this stable release, you can now use the miro.board.group and group.ungroup methods to manage items, respectively.Example of grouping items and adding them to a frameconst shape = await miro.board.createShape()const card = await miro.board.createCard()const text = await miro.board.createText()const items = [shape, card, text]const group = await miro.board.group({items})const frame = await miro.board.createFrame();// shape, card and text will also be added to the frame// you can check their parentId property after this operationawait frame.add(group)Groups do not support the following capabilities:Mind maps Tags MetadataFor more details on these new methods, refer to our documentation on group and ungroup methods in the Web SDK.

AdilsonContributor

Developer platform and APIs

Is Frame's childrenId property readonly?

I’m trying to set the childrenIds of a frame via the Web SDK but it seems its not allowed. The documentation doesn’t mention that it’s a read-only property. Is it possible to associate frames and their content programmatically?Frame (miro.com)

cortiez52New Here

Developer platform and APIs

When is this functionality going to be accessible?

Current Mode in Webex ConferencesA green Share button shows as soon as you open a poll. As soon as you click it, Slido Present mode is shared with your attendees. You are no longer sharing Present mode with participants when you select Stop sharing.

Anatoly BusyginNew Here

Developer platform and APIs

Using Micro Web SDK via iframe

Hello! Can I use Miro Web SDK if I embed my boards via iframe to my application? (I connected board as here Live Embed with BoardsPicker for registered users (miro.com))I want to do that:const item = await miro.board.get({ id: id })await miro.board.viewport.zoomTo(item)but I don’t understand how to get miro object from iframe in my application.I tried to do that:document.getElementsByClassName('miro-embedded-board')[0].contentWindow.miro, but I get error: Uncaught DOMException: Failed to read a named property 'miro' from 'Window': Blocked a frame with origin “https://my-link” from accessing a cross-origin frame. at HTMLDocument.<anonymous>Thanks.

KIng KalyanBeginner

Developer platform and APIs

Looker Alert Issue

I am new to Looker and trying to create my first alert. The requirement is simple when a status field (calculated field) is greater than 1 looker should send an email. Though a couple of records value is more than 1 still not sending an alert. I didn’t schedule a delivery, just created an alert.

shawngNew Here

Developer platform and APIs

general area for keyboard shortcuts

the keyboard shortcuts should all be on either the right or left side of the keyboard as opposed to being name related (P for pen, T for text, etc.). this makes it very hard to operate one-handed. if my right hand is on the mouse, my left hand is on the left side of my keyboard. i don’t want to make my right hand leave the mouse nor drag my left hand to the right side of the keyboard.at the least, this shoudl be an option to choose from.

jkowalskiNew Here

Developer platform and APIs

Adding a custom field blocks the possibility of changing data in the card preview

Hi I have a problem and can't find any information about it.I use the method miro.board.createCard to create new cards described on the page https://developers.miro.com/docs/card_card-1If I don't add cusftom fields i.e. leave the array empty ( fields: [] ) - by clicking the detail preview icon for the card - I can edit the fields (color, author, description, etc.) However, if you add a custom fieldfields: [ { value: 'Bug fix', iconUrl: 'https://cdn-icons-png.flaticon.com/512/3867/3867669.png', iconShape: 'round', fillColor: '#E5E5E5', textColor: '#000000', tooltip: 'Caption text displayed in a tooltip when clicking or hovering over the preview field', }, ],- in this preview all fields are lockedI cannot change them here.However, from the toolbar I can do it (for some fields)This bar allows you to change the fields: color, status, date, author, tag, etc. However, you cannot provide a description.Question:Why are the fields in the preview blocked after adding custom firlds and cannot be

AtleBeginner

Developer platform and APIs

Access team name in SDK?

Is there a way to read the team name through the SDK? Or do i have to make a backend REST call to fetch the team name? (One problem i see with this approach is that the Team API is only available on the Enterprise plan - which makes sense for more complex team integrations like sync etc, but for just reading the team name its a bit overkill.)

Joel HNew Here

Developer platform and APIs

Tired of manually managing Miro Licenses?

Hey everyone, can I get your input on this tool we're launching on the Miro app store?Here's how it works right now: If a user doesn't log in or shows no activity on Miro for 90 days, they'll get notified to confirm they still want access, if they opt out and say they don't want access, we'll remove their license.Helpful? Meh? Let me know!

Stacey FortunaNew Here

Developer platform and APIs

Embedding frame only to an external link

Use case: I copied a miro frame’s link and pasted/embedded it to an external tool like ClickUp Docs.Issue: Copying the frame link shows the entire board, which at times does not show the frame initially but some other part of the board. This could be a problem to non-miro users who will view the file from ClickUp. Embedding specific frame links to external tools like ClickUp can be really helpful for dynamic teams. who may change the contents frequently.

MewifoxiiiBeginner

Developer platform and APIs

The tools are not shown

I have a Starter plan, and I can't invite a student to the board, I copy the link that has the "edit" permission, he follows the link, but the tools are not shown. What to do?

KristenFlyNew Here

Developer platform and APIs

board doesn't work

Good afternoon!One of boards in a team doesn't work.. it contains a lot of important information.. other boards work great, but not this. It writes about bad connection, and tells to reconnect. But the internet is good. I tried to open it from different devices, but it still doesn't work.Please, can you help me?Regards,Kristen

Nataly2527New Here

Developer platform and APIs

Пропал доступ к моей доске

Я создала доску на бесплатном тарифе, все было нормально, но сегодня я не смогла ее найти у себя в аккаунте, по ссылке, которую я давала для доступа, сказано, что он закрыт, как такое может быть, если эту доску создавала я?? Помогите вернуть доску обратно

French to go AdministrationNew Here

Developer platform and APIs

Tool bar removal during presentation?

I would like to know if it's possible on the prensentation mode to remove the tool bar (please see screenshot) that is presenting the different modification we can do).

DybolNew Here

Developer platform and APIs

Customization of embedded board

Hello,I would have some questions regarding possibilities of customizing miro board. My goal is to embed miro board into my website and use it to my own private lessons. Therefore, I’d have couple of questions:Is it possible to export the board to PDF if the board is embedded? I don’t see such option, for me it is only visible on regular miro board, not embedded one. Is it possible to customize the UI (I’m mostly interested really simple UI, like at webwhiteboard.com - since I’d only use miro to write things) Is it possible to add ‘Video chat’ icon to the main top panel - so that it is visible right away (or ideally, start video chat right after joining the board) I tried to look into the documentation, but I didn’t find the answers. I would appreciate your help.Best regardsMikołaj

William BishopMironeer

Developer platform and APIs

NEW: Experimental release of Session Management and Attention Management in Web SDK

Hey, everyone!We’re excited to share that Session Management and Attention Management capabilities are now available in experimental release in the collaboration namespace miro.board.collaboration in the Web SDK.These new methods and components allow you to handle collaborative features on Miro boards, including: session management, attention management, remote viewport control, and more. With this experimental release, you can:Create collaborative experiences across multiple users on the same board Handle collaborative features on Miro boards, including: Starting and ending collaborative sessions Attention management Control the viewport Subscribe to events related to when users join or leave a collaborative session➡ Ready to get started? Visit our documentation to start working with these new capabilities:https://developers.miro.com/changelog/2023-11-27-changelog

Miguel ContenteNew Here

Developer platform and APIs

PlantUML Modal wrong dimensions

The Modal for plantUML started getting the wrong sizing around 2 days ago. In a full screen both the editor and preview are only occupying 15% of the available screen height.

Show more activity

News & Announcements

Questions & Ideas

Powered by Gainsight

Terms & Conditions Accessibility statement

Sign up

Already have an account? Login

Log in with your Miro account Login with Token

Log in to the community

No account yet? Create an account

Log in with your Miro account Login with Token

Enter your E-mail address. We'll send you an e-mail with instructions to reset your password.

Enter your e-mail address

Back to overview