Developer platform and APIs

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

  • 771 Topics
  • 2,514 Replies

771 Topics

J
J-TPMBeginner
posted in Developer platform and APIs

Export mindmap in OPML format

It would be very useful if we could use Miro during workshops/presentations to create/edit mindmaps and then have ability to export the mindmap in .opml format. This is especially useful for SDET/QA software testers and during requirements gathering. OPML file can then be uploaded to certain test management tools (for example Xray) This is an XML format for outlines https://en.wikipedia.org/wiki/OPML 

0
N
2 months ago
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?

3
Falk Köppe
3 months ago
C
Carlos SouzaBeginner
posted in Developer platform and APIs

500 Error on get-items-by-tag endpoint

Hi, it appears the https://developers.miro.com/reference/get-items-by-tag API endpoint is returning 500 errors.I’ve tried it with different tag_id values and no luck.Is there anything wrong with this endpoint ?Thanks!

6
C
3 months ago
S
Sabyh AhmedNew Here
posted in Developer platform and APIs

v1 app not showing in created app in miro

We have an old app created by one of our team members but if i login from his user and go to created app section its not showing me that app I have to change configurations of the app can you tell me guys where can i change configuration of that app

1
C
Mironeer
3 months ago
G
Geir ØlnesBeginner
posted in Developer platform and APIs

event for items:delete not fired for Connectors

I have one callback function that is set up with “on(event: 'items:delete' …..” and one callback function set up with the “on(event: 'items:create' …..”The create callback is called for all item types I have tested. The delete callback It is called for all item types I have tested except for type==ConnectorIs this intended fuctionality, or is it a bug?

0
G
3 months ago
T
Tyler WoodsNew Here
posted in Developer platform and APIs

Error connecting via a Miro App

I’ve opened a support ticket but haven’t heard back so figured I’d try here. Going to be a bit vague so that I don’t divulge anything sensitive, this is why I opened a support ticket…So I’ve got another company that can connect to Miro and these are their instructions for doing so:Then, you'll need to retrieve your app credentials. To do this:1. Click your profile image in the upper-right corner, and choose "Settings"2. Click "Profile Settings", and navigate to "Your Apps" tab3. Click the name of the app in the Created Apps section. This will display your app credentials4. Copy the "Client ID" and paste it in the corresponding field5. Copy the "Client secret" and paste it in the corresponding field6. Click Connect. This will open a new window7. Select the team to integrate with from the dropdown8. Click Install & AuthorizeTheir instructions are a bit out of date by step eight but the same thing applies I figured. When completing the above I get this error:This application cannot be

1
C
Mironeer
3 months ago
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs

Miro Web SDK 2.0 announces the experimental release of the `getVotingResults` method for paid plans that have access to the voting feature

Hey, Miro Developers! We’re excited to announce experimental release of the getVotingResults method for paid plans that have access to the voting feature. The getVotingResults method fetches the results of voting sessions belonging to a board. This method is available only on paid plans that have access to the voting feature.  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, or in our #experimental channel on Discord:https://discord.gg/G8KFgnkCc5 Important: Please keep in mind that this is an experimental feature, 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 version of this capability possible! Ready to get started? Visit our Documentation to start working with

0
Mira Balani
Mironeer
3 months ago
M
Monica PaskvanNew Here
posted in Developer platform and APIs

Duplicates with Jira Integration

How does Miro avoid creation of duplicates with the 2 way push between Miro-Jira (i.e., duplicate objects from Miro to Jira and also Jira to Miro)? Perhaps @Shubangi Sunder has some more info or a video explaining how creating duplicates are avoided in either app (JIRA or Miro)?Thanks.

0
M
3 months ago
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs

Miro REST API introduces create items in bulk

Hey, Miro Developers! We’re excited to announce the experimental support for creating items in bulk with our REST API. This initial release supports the creation of multiple, different types of items to a board, in a single call. You can add up to 20 items of the same or different type per create call. For example, you can create 3 shape items, 4 card items, and 5 sticky notes in one create call.  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, or in our #experimental channel on Discord:https://discord.gg/G8KFgnkCc5Important: Please keep in mind that this is an experimental feature, 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 version of this capability possib

1
aman
3 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Help us improve Miro for developers: developer survey

Hey, developers! We’re working hard to improve the developer experience of building and publishing apps and your feedback is vital to our work.If you’re a new or experienced Miro developer, we want to learn more about your motivations for building apps and the experiences you’ve had so far. Please complete our short survey and be in with the chance to win one of three $100 rewards.  Take the survey now ➡️ 

0
William Bishop
Mironeer
3 months ago
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? 

4
Jens Thiemann
3 months ago
A
Andre BennettNew Here
posted in Developer platform and APIs

API to cancel Invitations

I was looking through the APIs but I might have missed it. Is there an API/endpoint that would allow to check and cancel/delete invitations of users.Currently, when trying to create an account, it would fail if the account has pending invitations and login is set to SSO.

2
R
3 months ago
A
Alastair LeeNew Here
posted in Developer platform and APIs

Start numbering from X

I want to be able to type:An itemBut when I type that, Miro recognises that the 2 is a number and converts the text to a numbered list and changes the 2 to a 1.You can’t have a numbered list start with anything other than a 1.   

0
A
3 months ago
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

2
Josip Janzic
Mironeer
2 months ago
A
Abhinav GuptaNew Here
posted in Developer platform and APIs

Custom shape widge as an app

Hi Guys I have a use case to create a custom shape widget on the Miro board where in a user can add one or more widget [ lets call it a card ]. Inside each card - I want to add some information in each tab and I can add or delete tabs ( rows ) as per the requirements. Widget should allow editing the information in each block.  Please visit this link to have a visual idea about the image - https://i.ibb.co/r6ssh6k/custom-widget.png I need your suggestions - How can I create this and use it on the development canvas board?  ThanksAbhinav 

1
Josip Janzic
Mironeer
3 months ago
Alexander Akhtyrtsev
Alexander AkhtyrtsevBeginner
posted in Developer platform and APIs

Boards picker for unregistered users "This board is private" issue.

Hello there,Having a problem with embedding Miro inside another iframe.It says “This is a private board”.I’ve submited the form to get access to boards picker component according to documentation.Here is the code:miroBoardsPicker.open({ clientId: clientId, action: 'access-link', allowCreateAnonymousBoards: true, getToken: async () => axios.post('/obtain-jwt').then(r => r.data), error: e => { console.log('on error', e) }, cancel: () => { console.log('on cancel') }, success: async function (result) { console.log(result) window.open(result.accessLink) }, }) It works well upon opening the access link in the separate window via window.open()Access Link example: https://miro.com/app/live-embed/uXjVMBMXOW0=/?boardAccessToken=5GDDy0S9quNzU4zH3U4jtsktWiJbpgKV&autoplay=trueHowever inside iframe some XHR requests falling with 403 error.​​​​​I noticed, that i

7
Alexander Akhtyrtsev
3 months ago
U
Unleash QA1New Here
posted in Developer platform and APIs

An error occured while retrieving the subscription. Contact support to request assistance.

Hello community!I found a strange error going through logs, which is not reproducible so easily. The error message is “An error occurred while retrieving the subscription. Contact support to request assistance”, status is 400 and the code is “7.0913”.Does this happen to anyone and can any information be provided in order to understand the error ?Thanks in advance

2
U
3 months ago
S
Steffen BeckerBeginner
posted in Developer platform and APIs

Jira Cards (DC) with OAuth 2.0

Hello,I struggle to install Jira Cards with our onprem Jira instance (DataCenter) using OAuth 2.0.What I read from Miro documentation is that OAuth 1.0 is used for onprem Jira instances.In the german version it is even said that:The protocol used is OAuth 1.0.Currently Atlassian only supports this protocol. OAuth 2.0 authorisation code (3LO) is currently in developer preview.https://help.miro.com/hc/de/articles/360013463739-Jira-Karten-FAQWhich is clearly untrue because our Jira instances (v9.x) uses OAuth 2.0 by default.That’s why the connection between Jira and Miro does not work for our instance, because Miro only supports OAuth 1.0. So my question is: How can I connect Miro to Jira (DC) - while Miro only supports OAuth 1.0 but Jira only supports OAuth 2.0?

0
S
3 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Developer Challenge: Where's Miro? Scavenger Hunt!

 Introducing our new Developer Challenge Hey, devs! Ready for a challenge?Check out the Miro Developer Platform's Web SDK Scavenger Hunt 🔎Level up and use Miro's Web SDK to interact with your boards, using just our built-in console. 🤖Get Started and earn a surprise developer badge:https://bit.ly/43dwkni

0
William Bishop
Mironeer
4 months ago
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

6
T
9 days ago
Mira Balani
Mironeer
Mira BalaniMironeer
posted in Developer platform and APIs

The Miro Web SDK 2.0 introduces mind maps

Good day Miro developers! 😃 We have some good news to share! The Miro Web SDK 2.0 introduces mind maps in its experimental release today. Create, read, update, or delete mind maps to programmatically represent and interact with complex structures of information into Miro boards. With minimal development effort, you can also seamlessly import and export from third-party tools, or transform mind map information into other item types in Miro.For more information, do check out the following resources:Mind maps change log Mind maps overview Mind maps reference guide How-to guide on creating a mind map from a CSV fileHave fun trying it out! Cheers,Mira  

0
Mira Balani
Mironeer
4 months ago
N
NataliMaRisNew Here
posted in Developer platform and APIs

The app panel does not appear to the other users of my team when I am collaborating in real time with them.

When several users are in the same board, they not see the left-side panel where the app is running. They can use the app independently, but it does not show them what the administrator is doing at the moment in his panel.For example, if I'm inserting a word into wordle app , they don't see the word that i am writting ,and they can´t insert a word. But if i add a sticky note they inmediately see it on the board and they can edit it.administrator :member:In the screenshot , both users are at the same time in the same board. Both see the board, but only one the panel app.The panel where the app that I have developed is running does not allow me to share it in real time with the other team members. My question is: is there any possibility that the panel where the app is running can be shared just like the board is shared?

1
William Bishop
Mironeer
4 months ago
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

14
William Bishop
Mironeer
2 months ago
M
Manjunatha CitragarNew Here
posted in Developer platform and APIs

Live Embed Miro Board Events

Hi Team,        Is there a way to capture user interactions with Live embed Miro board? I want to  capture the those events and replay them later re-creating entire interaction with the board programmatically.  Thank you

1
William Bishop
Mironeer
4 months ago
P
pholzNew Here
posted in Developer platform and APIs

How to change the order of the presentation frames using Web SDK?

I use an async call to create a number of frames with `createFrame()`. When I go into “Presentation Mode” in the UI, the order seems random (or influenced by the async call). Using the UI sidebar, I can of course change the order. How can I do this programmatically? Is there a property such as `presentationOrder` for frames?

1
Mira Balani
Mironeer
4 months ago
Terms & Conditions