Skip to main content

Developer platform and APIs

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

  • 1,045 Topics
  • 3,285 Replies
1040 Topics
C
Cathy KincaidNew Here
posted in Developer platform and APIs
Custom Colors

Could we save custom colors so they are available anywhere across Miro.

572
C
P
Pepe CáceresBeginner
posted in Developer platform and APIs
Cards created with API are not shown with the right color

The problem was in my side!! 

130
P
J
Joseph LowBeginner
posted in Developer platform and APIs
Issue with uploading app icon

I have been trying to upload my new app icons (which I believe follow Miro’s App Icon guiddelines, but have been getting an error of “Error while parsing svg file: $cvc-complex-type.4: Attribute 'type' must appear  on element 'style'.”.  Any clue how I could go about resolving this? 

763
Mettin
Mironeer
K
kranthitechBeginner
asked in Developer platform and APIs
Embedding our app on a Miro Board

Hello to everyone at the Miro Community. I'm building a Mindmapping app, and most of our users already use Miro. I wanted to know if there is a way to embed our app into a Miro board.  I've seen a video that shows an embedded google doc on Miro. Is it possible to create such integrations for other apps as well?  The documentation shows how to embed Miro boards in other apps ( like google hangouts), but is the reverse possible i.e. embedded our app into a Miro board?  Thank you. 

994
K
S
sydunixNew Here
posted in Developer platform and APIs
[RESOLVED] Help - Opened a free Miro account to test API and Web SDK but not issued client ID

Hello Team,I am trying to test the API and SDK on a free miro account, but I don’t have a client ID nor been issued one.I have checked user profile and apps in settings.From the documention, I need to have a client ID to register my app to start with, before attempting to use the API.Is the client ID unique to a user or app?If unique to a user, shouldn’t a default one be created on opening a miro account?Or do I have to specially request one? If yes, shouldn’t that be in the Documentation?Thanks.

401
S
T
thinksecureNew Here
posted in Developer platform and APIs
Is Multi-Tenant support will be in the roadmap?

Our company acquires other companies which are using this application so we would like to know if you have any plan in the future to support this feature? Thanks in advance for the answer. 

971
Kiron Bondale
I
Ian MitchellNew Here
posted in Developer platform and APIs
Getting started with REST API from .NET client

I’m struggling to get started accessing the MIRO Rest API from a windows client.I have created a Developer Team board to test, which seems to give me some of the authorization data which the API docmentation describes. I was rather hoping to get into all the authentication stuff later on - right now, I need to investigate how easy it is to pull Miro data from my little test board.Does anyone have a C# (or better still Vb.net) example of reading a developer board ? Is this even possible from a Windows machine which isn’t running a web server?

2851
Addison Schultz
Mironeer
Ronny Roeller
Ronny RoellerBeginner
posted in Developer platform and APIs
Miro embed changes scroll position of embedding page

DescriptionTrigger the load of an embedded Miro board changes the scroll position of the page.ReproductionSteps to reproduce:Embed Miro board into Scroll down, so that only a part of the Miro embed is visible Click [See the board] buttonSee here a recording when embedding Miro into Notion.so (we same behavior embedding in our own app):Actual behaviorPage scroll to the top once Miro board is loaded.Expected behaviorPage scroll position doesn’t change due to loading Miro board. 

2378
T
C
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?

231
Addison Schultz
Mironeer
William Bishop
Mironeer
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

1130
William Bishop
Mironeer
ronny
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`.

7274
Anthony Roux
Mironeer
A
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

836
A
Daniel Fosco
Mironeer
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

2722
Henrik Ståhl
T
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?

555
William Bishop
Mironeer
S
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?

17134
D
William Bishop
Mironeer
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

1421
William Bishop
Mironeer
M
MasBarBeginner
posted in Developer platform and APIs
Read-only keys

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?

344
William Bishop
Mironeer
Daniel Fosco
Mironeer
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!

270
Daniel Fosco
Mironeer
L
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.

561
William Bishop
Mironeer
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

8684
B
P
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?

592
Robert Johnson
A
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':

1167
William Bishop
Mironeer
T
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  

222
T
E
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.

352
E
T
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?

783
William Bishop
Mironeer
Terms & Conditions