Skip to main content

Developer platform and APIs

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

  • 1,136 Topics
  • 3,455 Replies
1136 Topics
S
Simon BergeronNew Here
posted in Developer platform and APIs
Miro boards API pagination does not seem accurate

Hello, we are trying to extract boards data form the boards API. We are using the limit + offset pagination, but are seeing discrepencies with the number of records returned by each call.We set the limit to 50, but the number of rows returned can be lower than 50. Sometimes 47 or 42. To be clear, this is not the last page of the offset, so the number of records should be 50. Is this a bug on the API pagination?Thanks for your help,Simon

1182
Josip Janzic
Mironeer
N
Nikhil SachdevaBeginner
posted in Developer platform and APIs
Sticky Notes do not seem to support HTML based rich text styling

We use the Miro create sticky note item API (https://developers.miro.com/reference/create-sticky-note-item) and send HTML in the content field. We notice that the CSS styling (ex:  font-style: italic; etc) is not being reflected in the sticky note in default display (however its visible when it is in “edit” state). This seems to be a regression since this was visible before in default display. Can you suggest a way in which we can use the Sticky Note API to create notes with stylised (italics, bold, underline etc) content?

851
William Bishop
Mironeer
Maximilian Steverding
Maximilian SteverdingBeginner
posted in Developer platform and APIs
Get user id in Web SDK

I am currently building a Web-App with monetization. That beeing said to keep it simple i want to only use the Web SDK and do not want to use Rest API. Nevertheless i am associating the access_granted of the App with the Miro user_id. So in order to see wether a user has linked his user_id with a license key of mine i would need to request the user_id in the Web SDK. Is this somehow possible? I stumbled accross some old community posts, that do not seem to be relevant anymore as some functions got deprecated with the new Web SDK. I am looking forward to your suggestions as i would really like to avoid needing to make use of the Rest API in this case.Thank you very much!!

2843
William Bishop
Mironeer
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs
Miro REST API introduces flowchart shapes

Good day Miro developers! 🖖 😃 In our endeavor to extend our features and functionalities, the experimental release of shapes now supports flowchart shapes in addition to the basic shapes that we support in production. This experimental release supports read operations for flowchart shapes via the following APIs:Get shape item (experimental) Get items on board (experimental) Get specific item on board (experimental)For more information, see the changelog. Cheers,Mira

7029
T
B
Bhavana KumarBeginner
posted in Developer platform and APIs
Creating a Miro board with varied templates from a web application

Hello all, I want to create a react web application from which i can select multiple templates and then create a Miro board with all these templates. I am new to Miro and I am not sure how to proceed?. Kindly share your thoughts

941
William Bishop
Mironeer
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
July is a month for developers: Miro Apps Marathon

Hey, everyone!This July is a month dedicated to all things apps and integrations on the Miro Developer Platform—join in on our month of exploring, building and publishing Miro apps for some exclusive developer benefits!Submit an app to the Miro Marketplace during the month of July and you’ll receive a special bundle of developer benefits— from app promotion, to developer swag, to an exclusive Miro Developer badge, and more. Find out more and submit an app or integration this July.» Learn more Have an unpublished or private app that other Miro users would love? We’d love to share your handiwork with our global community of over 55 million users. Get inspired and join our next Developer Q&A session:» Join the conversation Cheers!Miro Developer Platform Team 

471
William Bishop
Mironeer
N
NastiaBeginner
asked in Developer platform and APIs
subscription was declined

Hi. In February this year I paid for a year Starter plan but now I can use only 3 Bords for editing, looks like my subscription was declined

584
N
J
JinggaNew Here
posted in Developer platform and APIs
Read and store data from Embed Miro Board into system's database

If I embed a miro board on my website and create a mindmap from there, is it possible to read and store the name of entities and relationships into my database? How do I do it? Thanks

631
William Bishop
Mironeer
Amjed Abdul Raheem
Amjed Abdul RaheemBeginner
posted in Developer platform and APIs
Creating Badges - Seeking Help and Guidance

Dear Miro Community,I am interested in learning how to create badges, and I'm reaching out to all the talented and experienced individuals here for some guidance and support. Badges are a great way to recognize and motivate users, and I believe they can add value to the community I'm a part of.I would like to know:1. What are the essential elements that make a badge effective and appealing?2. What are some best practices for designing badges, both in terms of visual appeal and clarity of purpose?3. Are there any specific tools or software that you recommend for badge design?4. How can badges be integrated into an online platform or community effectively?5. What are some creative ideas for badge categories and names that can align with various achievements or contributions within a community?If anyone has experience in creating badges or has seen successful badge implementations in other communities, I would greatly appreciate any insights you can share. Your advice will help me make ou

620
Amjed Abdul Raheem
M
Murilo GodoiNew Here
asked in Developer platform and APIs
Can Miro show tags attached by the API without refreshing the page?

I developed a program that reads a database with information on one column and classification on another. Then it uploads the info as stick note items and attach its classification as a tag. But when I run the program, the stick notes appear on the board, but I need to refresh the page to see the tags.Is there a way to show the classification without refreshing, or make the API refresh the page?The program is not an app on Miro, it is just a Python script with a tkinter interface.

671
O
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.  

556
Bentley Davis
S
SeanGPTNew Here
posted in Developer platform and APIs
refresh_token post data with query params?

Hi, Awesome platform and I love the documentation & onboarding for new developers, kudos to all the hard work! I am curious about the way to refresh an access_token described here:https://developers.miro.com/reference/get-new-access-token-using-refresh-token The docs suggest we should send a post request with our sensitive data as query paramshttps://api.miro.com/v1/oauth/token?grant_type=refresh_token&client_id=CLIENT_ID&client_secret=CLIENT_SECRET&refresh_token=REFRESH_TOKEN However, adding sensitive data to query params is generally not good practice:  Query parameters are often logged: Web servers or proxy servers may log the URLs, including the query parameters, which could expose sensitive data in logs. This poses a risk if the logs are accessible to unauthorized individuals. Query parameters may be stored in browser history: If the request is made through a web browser, the URL with the query parameters may be stored in the browser's history. If someone gains a

631
William Bishop
Mironeer
R
RamkumarBeginner
asked in Developer platform and APIs
How to retrieve user name from webplugin?

Is there any way to retrieve current user name with web plugin API, I see that there is an interface IUserInfo for user data, but not seeing how it can be fetched with API.

1942
Maximilian Steverding
M
Michael SanniNew Here
posted in Developer platform and APIs
Not receiving webhook events for comments

I noticed Miro not sending webhook events for comment but send notifications for other property change like stick_notes, text, shapes etc, is this a known issue and are there progress to fix it or how can we get comments events from the webhook ?

875
William Bishop
Mironeer
D
Dmytro KoziuberdaBeginner
posted in Developer platform and APIs
Bug related to Items endpoint

Hi all, I found such a pattern, which in my opinion is a bug, unless of course it is caused by the impossibility of development.Main: uploaded on the board item's "title" does not appear in the response until it is edited.Steps to reproduce:1) I create a board and with the help of "Drag & Drop" I throw several png files with predefined names onto it. For example, "Test_Image_1.png", "Test_Image_2.png", etc. (I think it works with other file types too, but I haven't checked)2) I make a request to extract all Items. For example, 'https://api.miro.com/v2/boards/<board_id>/items?limit=50' or 'https://api.miro.com/v2/boards/<board_id>/items?limit =50&type=image'3) I get the result with the correct number of elements, but in "data" the elements have only "imageUrl" and no "title", although it is there.Example:{..."createdBy" : {       "id" : "item_id",       "type" : "user"     },"data" : {       "imageUrl" : "https://api.miro.com/v2/boards/.....",   },....}4) If I someho

11314
William Bishop
Mironeer
M
Mark McIntyreBeginner
posted in Developer platform and APIs
Unable to search image names

Ive noticed if you upload an image called New_option1.jpg  you used to be able to use Miro search and type in the search inside Miro for a part of the name eg “new” or “option” and it would appear in the search.Now nothing at all comes comes up for some reason? Why is that

14111
Robert Johnson
V
Vít BilinecNew Here
posted in Developer platform and APIs
Redirect URL change

Hello, I wanted to add a new redirect URL since our domain has changed...but I am not able to do that, because we already went thorugh the app sumbission process like 6 months ago...Now it tells me to resubmit the app BUT even though I would go thorugh that there is no option to change or add new redirect URL. Can you please help me with that? Do you know the way how I can add the new address? Thank you in advance.

1261
William Bishop
Mironeer
S
saraTomBeginner
posted in Developer platform and APIs
Retrieve the name and extension of the image file.

Is there a way to get the image's file name and extension when using the Rest API or Web SDK? We use Miro for ideation and then wanted to load the data into the source system. 

62510
Robert Johnson
Jens Thiemann
Jens ThiemannBeginner
posted in Developer platform and APIs
An update of my own miro app is shown

Hi,I created an app for Miro and deployed it as version 0.9.I shared the app via the Installation URL and everything worked fine.Now I did an update and deployed this as version 0.91.With my normal user/browser, this update is not accessible.Even when doing reload of the board or granting access to the app via the Installation URL has no effect. Still, the old version of the app is used (see the “blue” profile).When I use a different browser profile (the “green” profile) and login with the same user, then the updated version is visible (v0.91).Now I wonder if this is a caching problem in the browser (chrome) and if I need to delete any data.Is there anything else I can do to force my normal browser to use the updated version of the app?

431
William Bishop
Mironeer
L
leon_00Beginner
posted in Developer platform and APIs
Get available apps by access token

Hey,i am looking for a solution track if an user has deleted our app.We are using the access token.Is there a way to get the available apps for the user by the access token?

491
William Bishop
Mironeer
R
Rob SchenkNew Here
posted in Developer platform and APIs
Getting the logs using API, but no data is returned

Hi, Im trying to get the logs using the API. i do get a 200 response but there is no data.  I’m using the following request :Invoke-WebRequest -Uri 'https://api.miro.com/v1/audit/logs?createdAfter=2023-05-27T05%3A34%3A08.000Z&createdBefore=2023-06-27T05%3A34%3A08.000Z&limit=500 The response is : {  "type": "list",  "limit": 500,  "offset": 0,  "size": 0,  "data": []} Any idea what i am doing wrong?

412
K
P
Pepe CáceresBeginner
posted in Developer platform and APIs
Creation of tag is not working properly

Hi!!! When trying to create a new tag, response always tells the tag already exists but it’s not correct.No matter wich title you specify, the response is always the same. Any idea of what is wrong?! Thanks!!! curl --request POST \     --url https://api.miro.com/v2/boards/<a valid board id>/tags \     --header 'Accept: application/json' \     --header 'Authorization: Bearer <a valid access token>' \     --header 'Content-Type: application/json' \     --data '{     "fillColor": "red",     "title": "levelCode"} Response:{  "type": "error",  "code": "6.0303",  "context": {    "boardId": "<a valid board id>"  },  "message": "Tag with title levelCode already exists",  "status": 400}

29310
Elena Ignatik
Mironeer
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.

510226
M
Jens Thiemann
Jens ThiemannBeginner
posted in Developer platform and APIs
Help with drag and drop of images // works only when dragging it twice

Hi,I want to create an app, which allows dragging images to the Miro board.I am using JavaScript vanilla.My problem:When dragging the image to the board, nothing happensMoving the mouse back to the app window, the cursor changes to the symbol:When now dragging the same image to the board, it is added. Additional information:When using it with any other element, like text, it works fine. Only for images, I need to drag them twice. Adding console.log, I can see, that my drop event which added the images, is only called when dragging the image the 2nd time.Any hint/clue, what I am doing wrong? 

3124
Jens Thiemann
Falk Köppe
Falk KöppeNew Here
posted in Developer platform and APIs
How to copy a board and place it in a project?

Hello,I’m successfully using thev2/boards?copy_fromendpoint (https://developers.miro.com/reference/copy-board), but the added “projectId” is ignored. The copied board is not placed in the project with the given “projectId”. I also do not get an error message, but a success message with the copied board details.How can I copy a board and place it in a project using the API “Copy board” endpoint?

893
Falk Köppe
Terms & Conditions