Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development. See documentation at <a href="https://developers.miro.com/docs">developers.miro.com</a>

983 Topics
3,102 Replies

Charles DarnellNew Here

posted in Developer platform and APIs

Starting with Zoom, I want to add the Affinity App and utilize this to conduct an affinity workshop.

This will be a Workshop with five to a dozen participants and a facilitator. I want to use Zoom for the general workspace. Add the Whiteboard app. Add the Miro Affinity app (template). Each participant will submit sticky notes that everyone can see. The facilitator can move the stickies around to group them under headers and columns. Is this possible?

William BishopMironeer

posted in Developer platform and APIs

Upcoming Workshop: Getting Started with Miro's Developer Platform

Miro Developer Platform Workshop: How to Build Apps that Unlock Collaboration for Millions of People Date: Tuesday, August 2nd, 2022, 5 pm CESTRegister here If you joined us at Miro Next, you know about our recent launch of our Developer Platform. To keep the conversation going, we’re hosting a series of workshops illustrating in-depth each of our platform’s unique capabilities. With Miro’s Developer Platform 2.0 you can:Create solutions that leverage libraries of images, assets, and more Visualize relationships between data across systems: generate an org chart using data from a spreadsheet Create content from other services and platforms, like quickly adding sticky notes from the phone on the board using a QR code Bring meetings to life with interactive ice breaker apps Join Miro Developer Advocates, Will Bishop and Addison Schultz, to explore how you can unlock collaboration with Miro’s new Developer Platform — by building an app or integration that empowers our global community o

ronnyContributor

posted in Developer platform and APIs

IDEA: Add hidden markers to widget

We create widgets via the Miro API and query them afterwards back. We need to know which widgets are what (e.g. to find stickers placed within a specific widget). So far, we rely on the text to match the enclosing widget. Yet, this leads to issues if users change the text in the Miro UI and it’s cumbersome if boards are localized (i.e. lots of text variants to match). (Aa an alternative, we considered storing the Miro widget ID but that’s tricky as it requires us to hold this state.) We would like to send a hidden marker to the API during widget creation, which is then returned when querying for widgets. As a parallel, consider the ID field in HTML elements: The developer sets it, website users don’t see it and can’t change it, yet developers can query the elements afterwards with this ID via `getElementById`.

Aleksandr ChilikinContributor

posted in Developer platform and APIs

Low board sharing speed

Hello. I’m sharing board using rest API. But sharing speed is quite low…about 4.91s/board. What the reason? Maybe something wrong? Python scripts using requests

Daniel FoscoMironeer

posted in Developer platform and APIs

Announcing the Mirotone UI Library!

Hey everyone! We're proud to announce the Mirotone UI Library for Figma, our newest resource to help you design apps for Miro! The library is a set of components and utilities in Figma to help you design apps that follow the visual language from Mirotone, our frontend library.To get the library, just head to the link below and click ‘Get a copy’ to add the file to your Figma account: 👉 Mirotone UI Library - Figma What's inside? Foundations: color styles and standard typography to build your layoutsComponents: all components currently available in Mirotone, and some extra!Utilities: additional components to help you prototype your apps Getting StartedIf you never used Figma before, or want to know more about the library, check out our video walkthrough. Feedback and UpdatesThis is the first release of many. If you have feedback on using the library, leave your comments here or in our Discord server. Future versions will be available on the Figma community, and you will need to duplicat

TimPBeginner

posted in Developer platform and APIs

BoardPicker integration issue

Hello, I have submitted the form with an integration request several days ago, but still having “integration is unavailable”. Should I wait for email from miro or what is the ETA on this process?

saifisBeginner

asked in Developer platform and APIs

The customization possibilties for cards

I've looked around the references and know to customize a lot of things like adding logos and such, but still aren’t sure if I can change the height and width or add tags to the cards via web SDK If there is a page somewhere I can look at to figure out the details of the card object creation?

William BishopMironeer

posted in Developer platform and APIs

Developer Q&A Weekly Sessions!

Hey, Everyone!We're exploring new ways to engage with our developer community and learn together, so we're excited to announce our new Developer Q&A sessions which will soon be offered weekly. These will replace our existing Office Hours starting this summer.But first, we want to hear from you what you’d like to see in these sessions. So, what's different?Community-requested topics for discussion Dedicated time for V2 Migration support each week How can you participate?Let us know below which topics you want to discuss and learn more about! We will check each week to get a list of topics suggested by the community In order to make sure we're offering the best experience, please share what other topics you'd like to see, as well as how you'd like to engage with us—for example:Discord live session (currently used for our Office Hours)? Zoom meeting/webinar? Other? Thanks for being a part of our developer community—we're looking forward to hearing from you all!- Miro Developer Relat

MasBarBeginner

posted in Developer platform and APIs

I’m trying to define a set of sticky notes for our internal use. To get all specific sticky inserted I need to identify them with an unique key. I can’t find a sticky prop to save it (like a metadata o similar); I’ve tried to use tag but it is modificable and it hasn't any readonly information to do this (as sticky props). Have you any idea?

Daniel FoscoMironeer

posted in Developer platform and APIs

Mirotone Library Survey

Hey everyone! Daniel from the Miro Platform group here! I'm part of the team working on Mirotone, our UI component library to build Miro apps 🙂 We are currently working on Javascript components for Mirotone to enable interactivity out of the box and reduce the amount of code you have to put into building app UIs.That takes us to the choice of Javascript framework: while some options are widely used and supported by the JS community, we still want to hear about your preferences in a framework. Please hit the link below to take a short survey to help us define our technical roadmap. The survey will run for about 2 weeks, and is also available as a popup in the Mirotone website. 👉 Take the survey Thanks in advance!

LeventNew Here

posted in Developer platform and APIs

Automation create team and add owner via API

Hi, We are busy to integrate Miro to our porfolio as standard application.To achieve some automation I'm stuck on following topic. We can create the team automaticly but we would like to add the owner aswell.We need to get the ID of the user by reverse lookup via UPN of user. At this moment there is a limit of 100 users to get users from the organisations. Is there any easier way by using the UPN or looking up the id of a specific user? Create the team add owneror in best case, create team based on a AD security group and add members based on members of this security group.

CigeyoBeginner

posted in Developer platform and APIs

API: create lines and paints

Hi!Is there any plans to implement possibility to create other resources (e.g. lines, paints, etc) via API?We are really missing it. Or maybe you can suggest some workaround? :) We are trying to create a whole board with all items via API.

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

pvillanuevabNew Here

posted in Developer platform and APIs

Crear botón para acceder directamente a una copia o duplicado de una pizarra

Buenas tardes alguien me podría ayudar en crear un botón para que la persona que le dé clic en el botón, esta pueda acceda directamente a la copia o duplicado de la pizarra compartida?

Andriy ZhylenkoContributor

posted in Developer platform and APIs

Cannot retrieve "widgets" via REST API v2?

Hello,I am confused with the object naming in API v2. In v1 the items on the board were called “widgets” and there was a corresponding API method to access them. In API v2 their analog seems to be “items”. However when I try to retrieve the list of items for the same board that is accessible via v1 - it just returns an empty list :-(https://api.miro.com/v2/boards/uXjVOLV4E3E=/items?limit=50{'cursor': '', 'data': [], 'limit': 0, 'size': 0, 'type': 'cursor-list'} https://api.miro.com/v1/boards/uXjVOLV4E3E=/widgets?limit=50{'data': [{'createdAt': '2022-02-21T14:57:12Z', 'createdBy': {'id': '3074457361785543958', 'name': 'Andriy Z', 'type': 'user'}, 'id': '3458764519418309756', 'mindmap': {'layout': 'butterfly', 'theme': 'colorBranch'}, 'modifiedAt': '2022-02-21T14:57:12Z', 'modifiedBy': {'id': '3074457361785543958', 'name': 'Andriy Z', 'type':

Tommy LinNew Here

posted in Developer platform and APIs

frames exceeds 100 the format of the numbering will be mixed with the number of page

Hi, MiroI would like to report a problem, when using the frames function, if the number exceeds 100, the format of the numbering will be mixed with the number of pagesNormally: 98. 139, 99. 140, 100. 141, but now 100141 appears, please refer to the picture for detailsMiro is my favorite distance teaching tool, thank you for developing such a fascinating piece of software

Emile Paffard-WrayBeginner

posted in Developer platform and APIs

FontSize not present on some items in REST API

I am migrating an app over to Miro’s V2 API and I’m finding that font sizes are not available in the the style object for text items. E.g. I have a text node that has the following style object:{ "fillColor": "#ffffffff", "fillOpacity": "1.0", "fontFamily": "open_sans", "textAlign": "left", "color": "#1a1a1a"} I know from looking at the board and by checking it on V1 of the API that this text item in fact has a font size of 144px, but this isn’t present on the V2 API response. Is there some way of retrieving this font size? Otherwise I am going to have to mix the V1 and V2 APIs which doesn’t exactly seem like good practice.

Tom GuestNew Here

posted in Developer platform and APIs

Update shape item API endpoint not working as expected

I’m using the PATCH https://api.miro.com/v2/boards/{board_id}/shapes/{shape_item_id} to try and change the text content and background colour of a shape. The request I am using (via https://beta.developers.miro.com/reference/rest-api-update-shape) is curl --request PATCH \ --url https://api.miro.com/v2/boards/<board_id>/shapes/3458764521610298308 \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "data": { "content": "new text" }, "style": { "fillColor": "#d0e17a" }}'which results in...{ "type": "error", "code": "invalidParameters", "message": "Position (x and y) is required", "status": 400}if change the request to only include the “style” section i get a 200 response.I have added a position block but that doesn’t change the response.Any ideas?

posted in Developer platform and APIs

Web SDK Quickstart not working

I have very basic programming skills and I'm struggling to even get started with Miro Web SDK. I'm trying to follow the quickstart guide: https://developers.miro.com/docs/try-out-the-web-sdk and having the following problems: First, I'm getting a completely different output when I enter "miro.board" into the developer console. According to the documentation, I’m supposed to get:N {ui:W, viewport: X, getIdToken: f, getAppData: f, setAppData: f}But instead I’m getting:{getOnlineUsers: ƒ, __getParamsFromURL: ƒ, __disableLeftClickOnCanvas: ƒ, __enableLeftClickOnCanvas: ƒ, getAllObjects: ƒ, …} Then, when I enter the example code for creating a shape item:const shape = await miro.board.createShape({ content: '<p>This is a very yellow star shape.</p>', shape: 'star', style: { fillColor: '#FEFF45', }, x: 3000, y: 4500, width: 280, height: 280,}); I get an error messageUncaught TypeError: miro.board.createShape is not a function at <anonymous>:1:32 What am

Ekat_logNew Here

posted in Developer platform and APIs

Problem with a frame

Hi everyone, after the 18/06 I have a problem with one of the frames on my board. It is not editable and I can’t even pick it to delete. Problem isn’t solved with opening the board in a new browser. Here is the picture.

Bernadetta BurekNew Here

posted in Developer platform and APIs

Miro sketch plugin is not syncing

Hello, Why I can’t sync the Sketch files with Miro,I updated everything and I have the newest version of both programs,My colleague has the same issue,

Cameron CrossNew Here

asked in Developer platform and APIs

Integrate user access to display personal miro boards on our website

Hi! I'm hoping some knowledgeable community member can help. I have a website where users create spaces and I want to allow users to display a specific miro board in the space. They may have multiple spaces and can one 1 board to each space. So, we need a way for a user to click a button, login to their miro account, select a board and then save the iframe details to their space in my site. Any thoughts on what api etc exists? Thanks in advanceCameron