Skip to main content

Developer platform and APIs

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

  • 1,123 Topics
  • 3,435 Replies
1123 Topics
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 ?

865
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

10814
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

13411
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.

1251
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. 

60310
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?

411
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?

481
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?

402
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}

28610
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.

507626
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? 

3074
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?

873
Falk Köppe
R
ReniNew Here
asked in Developer platform and APIs
Restoring the board

Hello, I accidentally deleted all the boards, is it possible to restore them somehow?

552
Robert Johnson
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!

596
C
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

261
C
Mironeer
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

2621
C
Mironeer
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?

140
G
C
Carlos LópezBeginner
posted in Developer platform and APIs
Did Miro update the way permissions work? Getting a Insufficient permissions error with out code change

Had configured our app to create boards from other boards (by copying them), and suddenly it stop workingThis is our flow, we call : "https://api.miro.com/v1/oauth/token?grant_type=authorization_code"Then we call:url = URI("https://api.miro.com/v2/boards?copy_from=#{template_id}")And we are getting this error"Full body {\"type\"=>\"error\", \"code\"=>\"4.0602\", \"context\"=>{\"boardId\"=>\"xxxxx=\"}, \"message\"=>\"Insufficient permissions to perform operation. Please check the permissions or contact support\", \"status\"=>403}"Permissions have not been changed in monthsApp has permissions to read / write and original board has view permissions for every one, this error started appearing jus a few weeks ago.

4995
M
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.

262
R
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

620
Mira Balani
Mironeer
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

1761
aman
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.

420
M
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 ➡️ 

250
William Bishop
Mironeer
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.   

1260
A
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

1247
Alexander Akhtyrtsev
Terms & Conditions