Developer platform and APIs

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

  • 675 Topics
  • 2,224 Replies

675 Topics

Will Bishop
Mironeer
Will BishopMironeer
posted in Developer platform and APIs

Building an app? We want to hear from you!

Hey, Miro App Developers! Building an app? We’d like to hear from you! If you’re building an app on the Miro Developer Platform, we hope you might have a few minutes to complete our short survey about Miro app development and your use cases:Developer Insights SurveyWe’re focused on making sure we’re meeting the right needs of developers, and your voice is invaluable to us!  Cheers,Miro Developer Platform Team

0
Will Bishop
Mironeer
23 days ago
Will Bishop
Mironeer
Will BishopMironeer
posted in Developer platform and APIs

Find us on Developer Q&A every Wednesday at 5:30PM CEST

Hey, Miro developers! We’d like to invite you to join our weekly Developer Q&A sessions, a dedicated time for you to get insights on any questions or topics you might have. It is hosted by our Developer Relations team and often we will also have special guests from the Developer Platform engineering and product team to cover more specific topics.  When: every Wednesday at 5:30PM CEST/ 9:30AM CT, lasting for 30 min. Where: on our Discord channel #developer-Q&A-sessionsWho can join: everyone exploring or building with the Miro Developer Platform is welcome to join - no matter how much experience you have with the Platform, this time is for you.  How to submit topics for discussion:Interested in exploring a specific topic, or have questions on something in particular? Feel free to let us know by adding a comment in this thread or sharing your ideas with us on Discord! For more common questions and topics, feel free to bring up during the session - no advance needed.  We often also

0
Will Bishop
Mironeer
2 months ago
Daniel Fosco
Mironeer
Daniel FoscoMironeer
posted in Developer platform and APIs

Announcing App Manifests

Hey everyone, I'm Daniel, product designer with the Miro Platform team. We're happy to announce our new platform feature App Manifests is now available in beta!  The app manifest is a YAML file that describes all the settings of your app. It enables you to quickly edit settings and replicate configuration between apps—with more capabilities coming soon. This is an optional feature that does not affect the existing settings page: you can keep using it normally, and any setting changes will be reflected between the UI and manifest. Also, all of our app examples on Github have been updated with app-manifest.yaml files, so it's even easier to get started with one of them! Check out the video below for more details of how it works, or just head to your app settings and click "Edit in Manifest". This feature is available to all Miro customers with a developer team. Feel free to share your feedback and thoughts about this feature: what works for you, what doesn't, and what else would you like

0
Daniel Fosco
Mironeer
2 months ago
Will Bishop
Mironeer
Will BishopMironeer
posted in Developer platform and APIs

Announcing the public beta of Webhooks!

Miro Developer Changelog EntryHey, everyone!Over the last few months, we’ve been hard at work building out the beta of a much anticipated capability, webhooks. Today, we’re excited to open this up for public beta, and we can’t wait to see how you all leverage webhooks to extend the power of the Miro Developer Platform. 🚀 In this initial iteration and beta period, webhooks support the update, creation, and deletion of board items.  It’s really important to us that we can create the best possible developer experience when it comes to this new capability, so please share any and all of your feedback with us here in the thread below, or in the #public-betas channel on our Discord server!Important: Please keep in mind that this is an early beta, so you should not implement or rely on this capability in any kind of production environment, as there may be changes, bugs, etc. We’ll be sharing all feedback directly with our Product and Engineering teams to ensure we’re creating the best versio

0
Will Bishop
Mironeer
3 months ago
Josip Janzic
Mironeer
Josip JanzicMironeer
posted in Developer platform and APIs

Node.JS client: the easiest way to integrate with Miro’s API

Hi everyone,Using the Miro REST API just became a lot easier with the release of the official Node.js client library! If you’re using Node.js to develop your Miro apps, this release will reduce the amount and the complexity of code you need to write. By using the client library you get the following benefits: Documented methods for every REST API endpoint  Effortless OAuth 2.0 authorization Automatic management of access and refresh tokens Simple integration with various frameworks and databases Automatic pagination We have also released a new version of the Miro starter kit: create-miro-app. It generates a boilerplate with all the code necessary to run a simple WebSDK and REST API app.Try it out by running: npx create-miro-app@latest.To get started install the @mirohq/miro-api NPM package and check our quick start guide.

0
Josip Janzic
Mironeer
5 months ago
Will Bishop
Mironeer
Will BishopMironeer
posted in Developer platform and APIs

Webinar Recording: Getting Started with the Miro Developer Platform

Hey, everyone!  👋Last month we hosted a developer webinar, where @Addison Schultz and I walked through how to get started with the Miro Developer Platform. We’ve now made this webinar available for everyone to watch and would like to invite you to go have a look here:In this webinar, you'll learn how to quickly start calling our SDK and API endpoints and developing an app or integration of your own on Miro. There are plenty of best practices and tips that can be helpful when you are developing with the Miro Developer Platform.Hope you find this content useful and enjoy the webinar!Will & AddisonP.S. If there are any specific topics you'd like us to cover in future webinars please let us know on this thread, we'd love to hear your opinion 😀

0
Will Bishop
Mironeer
6 months ago
T
Terril JohnsonNew Here
posted in Developer platform and APIs

Frame embedding into multiple boards

I would love a feature where a single frame (including all content inside that frame) could be displayed and edited in multiple boards! EX.  My team created a “project planning” board that keeps progress/ tasks/ activities/ and assignments for all our projects. We link to individual boards for each project inside that board.  I would be great if there was a way to have that specific project plan viewable inside that project Miro board.  we then could plan out and update that progress inside that project board and the same information would update in the project planning board! I hope this makes sense and would be happy to answer questions if this is not clear.ThanksTerriljohnson_terril_j@cat.com

2
M
18 hours ago
Bentley Davis
Bentley DavisBeginner
posted in Developer platform and APIs

Stretched App Icon on App Search in Miro Board

TLDR: Probably can be fixed by adding “object-fit: contain” to the CSS for “.library-root__item--list .library-root__item-icon” to the Miro Board.library-root__item--list .library-root__item-icon { width: 24px; height: 24px; margin-right: 16px; object-fit: contain;}Icons are sometimes stretched in the Apps search on the Mio Board.Should be:They do not show up stretched anywhere else. We submitted a square SVG but at some point it was converted to a PNG and any transparent space was trimmed. That png is properly displayed on the marketplace page with a object-fit: contains css. but the CSS on the Miro Board App Search display does not have the object-fit: contains CSS.We cannot think of a way to solve this on our end. We already submitted a square image. One idea was to add a white background but then the icon highlighting in the SVG icons for the app would not look proper.

0
Bentley Davis
2 days ago
A
AbdullahNew Here
posted in Developer platform and APIs

Bulk draw items via an api call

Hi, My use case is to create a diagram (similar to a uml class diagram) on the micro canvas. I basically parse complex code bases and after filtering and structuring relevant tokens parsed, I end up with a complex json data that has information about the different files, classes, variables, api calls etc. I want to draw a visual representation of that code base where an application is represented by a frame, and each file inside it forms a separate frame, which further contains shapes representing api calls and variables etc. I want to maintain the hierarchy in the diagram just like in the code itself- for example, a file containing a class, which in turn contains an api call, must be rendered as a frame (the file), containing another frame (the class) as its child, which finally contains a box representing the api call as its child.So, now that I have provided a context, I’ll come straight to the point. I did not find an api call where I could pass data for multiple items (frames, sha

3
Josip Janzic
Mironeer
2 days ago
T
thedarkstrixBeginner
posted in Developer platform and APIs

Something went wrong error | Live Embed with BoardsPicker for unregistered users

Hi , I am trying to create board for unregistered users . But getting “Something went wrong” in the board picker.The API’s :async function getTokenFromServer() { const response = await makeApiRequest( "POST", backendApi, "server/generate/jwt", false, { client_id: "...", // hidden client_secret: "...", //hidden } ); if (response.error) { console.log(response.message); return response?.message; } console.log("token", response.response.jwt_token); // this returns a JWT token <string> , there is no errors in this func return response.response.jwt_token;}export const initMiroBoard = () => (dispatch, getState) => { window.miroBoardsPicker.open({ clientId: "...", // hidden action: "access-link", allowCreateAnonymousBoards: true, getToken: () => getTokenFromServer(), success: (data) => { console.log("on success", data); dispatch(setMiroWhiteboard(data)); }, error: (e) => { console.log("on error",

9
T
3 days ago
J
John C.Beginner
asked in Developer platform and APIs

Managing created user accounts

1. If we programmatically create users for others can we make them with their personal email accounts? If so,  a. How do they set their password?  b. Can we programmatically set their password? 2. I imagine users get notifications when they're programmatically invited to a team, or new user account has been created for them; in general, is there a way to control which notifications are sent? I'd like for the app I'm building to control sending notifications by sending out a link to a shared board. 3. I want my users to only see the board shared with them, would they see anything outside of that? I.e. the miro user dashboard/home landing page.  a. If so, is there a way to lock their account down?

1
Josip Janzic
Mironeer
4 days ago
J
John C.Beginner
asked in Developer platform and APIs

Is there a way to programmatically create Miro accounts?

Hi,I'm new to Miro and development for it.  I like the ability to publicly share a link to my board to visitors for edit but am concerned about the link being comprised (possibly being sent to malicious users); so instead, in the app I'm creating, I'd like to know if there's a way to create Miro accounts programmatically when someone creates an account in the application I'm building so I can have users sign up for my site (and Miro) and be able to add them as contributors to a board later? I saw there's an API method to create a user, but I'm not sure this is the type of user I'm looking to create. Thanks, John C.

4
J
4 days ago
M
Mathias Sønderskov SchaltzBeginner
posted in Developer platform and APIs

bug on code block

Issue is that when you copy a code block all the “<” are changed to “& lr ;”  .. so formatting is ruined.

1
Josip Janzic
Mironeer
4 days ago
Bentley Davis
Bentley DavisBeginner
posted in Developer platform and APIs

Using enterSelectWidgetsMode multiple times makes the Object Menu move to the right

My app calls the V1 enterSelectWidgetsMode Miro SDK function. The first time the function is called it works as expected but the second time and each time after that the Object menu moves further to the right.  

5
Will Bishop
Mironeer
4 days ago
M
MillieNew Here
posted in Developer platform and APIs

apple pencil only drawing

So I’ve been using Miro with my Apple Pencil on my iPad for a while and have experienced no issues, however now I cannot do anything with my Apple Pencil other than draw on my whiteboards. I can’t move anything about or select anything with my Apple Pencil. I’ve switched off the “only drawing” selection in my settings so it’s not that haha.does anyone have the solution to this ?

0
M
7 days ago
G
Graham ClarkBeginner
posted in Developer platform and APIs

enable reddit to embed with Include Media Preview

in reddit: share>embed>copyin miro: embed iFrame code“The URL you are trying to submit is invalid” 

1
A
Mironeer
8 days ago
Robert Johnson
Robert JohnsonVolunteer Community Moderator
posted in Developer platform and APIs

Adding scrollbars to left panel (openPanel)

Hello. I am not a developer, but have enough past experience to fuddle my way through some things.I got the Drag and Drop example Web SDK 2.0 app up and running at Glitch.Now what I am trying to do, is add scrollbars to panel as some of the images are cutoff/not visible:All of the code I am using is here:https://github.com/miroapp/app-examples/tree/main/examples/drag-and-dropAnd I have been looking for information on adding a scrollbar here:https://developers.miro.com/docs/ui_boardui#openpanelBut I also understand that this may be something that should be obvious to a developer and is not unique/worth documenting in the Miro Developer Platform documentation.Any help is appreciated!

3
A
Mironeer
8 days ago
T
thedarkstrixBeginner
posted in Developer platform and APIs

How to control a embedded miro board using the web sdk

The problem : I want to details of the board (specifically the viewport of the board) , that i have embedded to my web app using live embed. I do have the board ID , and accessToken that is given by boardpicker . Is there way any to control the embedded miro board using the web sdk with the details that i already have ?Currently using the web sdk.js package to the project always returns empty viewport data, mostly because the app is NOT authenticated with the board embedded in my webapp .Any help is very much appreciated 

1
A
Mironeer
9 days ago
M
Maximilian HallettNew Here
asked in Developer platform and APIs

Connection Lines Size

A small question that probably doesn't have a solution yet. Is there way to get around the scaling parameters for the connection lines feature? I want to make my lines thicker in appearance because of the scales that I am working within my Miro Board. Subsequently my connection lines are thin in appearance even when set to the maximum thickness.

3
K
10 days ago
S
Sergey VorozhtsovBeginner
posted in Developer platform and APIs

Batch endpoints

Hi all.My case is - we render complex diagram with 1600 objects one the same board and other employees have read access. The board should be updated in some interval - every hour, for example.My first issue - posting. I post all those 1k+ object one by one which is slow and not efficient from CPU POV for both sides - miro and my app side.  Maybe miro developers can provide batch endpoint to accept list of objects?Next issue - recreating diagram, I can’t push only changes to the board, because logic would be super complex, because I’ll have to recalculate size of all elements, so it’s much easier for me to delete all and post everything again. My question is - How do I clean up the board with API? There is no such api right? I have to fetch all items by GET https://api.miro.com/v2/boards/{board_id}/itemsand then delete them ONE BY ONE withDELETE https://api.miro.com/v2/boards/{board_id}/items/{item_id}Is that correct? That’s ridiculous isn’t it?There should be batch endpoint for these o

3
Mettin
Mironeer
10 days ago
R
Robin ScottNew Here
posted in Developer platform and APIs

Importing AIrtable data to a Miro board

I am trying to create a miro board where is specifies business units, teams within that business unit. I have the data in Airtable. To help with keeping it current, I was wondering if there is a way to import the data instead of manual update the miro board. I am also open to another  suggestion. 

3
R
14 days ago
J
John C.Beginner
posted in Developer platform and APIs

BoardsPicker non-registered users same as visitor experience?

I want to have non-registered Miro users come to my website and use an embedded Miro board but I don't want Miro ads popping up asking them to either sign up or create an account so they could display their real name.  I also want control of the board so I can programmatically set permissions on the board, create the board from a copy of another board, or use the API however else I chose too.  I don't understand what the boardPicker does exactly, I see there's a client ID, so that leads me to think there's some type of authentication that could possibly run a board as a service account.  If what I'm thinking is true, would multiple non registered users be able to interact with the board or are there limitations? Thanks,John

1
Elena Ignatik
Mironeer
18 days ago
J
Jairo da Costa Barbosa FilhoNew Here
posted in Developer platform and APIs

Cant change to Free Restricted SCIM API

Im trying to do a script powershell with a function who changes ‘userType’ from ‘Full’ to  ‘Free Restricted’, but it dont work (error 400 ). I tried with PUT and PATCH methods.  If i try to change from ‘Full’ to ‘Free Restricted’ it works properly. Can i have a support? Thanks!

4
Elena Ignatik
Mironeer
18 days ago
K
kristen.englishNew Here
posted in Developer platform and APIs

Do you know how to delete ‘Super Search’ from Miro?

I didn’t know that it has a trial version. How can I delete it? Every time I try, it displays an error

1
Robert Johnson
19 days ago
Ethan Sherbondy
Ethan SherbondyBeginner
posted in Developer platform and APIs

Unable to modify config for a published Miro App? Expect there to be a resubmit flow for existing published Miro apps with updated config

Hi there, We have an existing published Miro app, and when we try to edit any config for it, we get an error message that it cannot be edited because the app is already published.Surely there must be some flow to edit and resubmit an existing app with updated config? Am I missing something, or does this require manual intervention by the Miro team to update an existing app?  What is the update flow for editing and resubmitting an existing published app?Or do you recommend creating a new app altogether in order to “update” it, then we share our latest new App ID with you once we are ready to resubmit?

1
C
Mironeer
21 days ago
Terms & Conditions