Developer platform and APIs

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

  • 769 Topics
  • 2,509 Replies

769 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

2
Josip Janzic
Mironeer
1 month 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
D
devsinghGMEBeginner
posted in Developer platform and APIs

Installing Jira Cards

I’ve been trying a variety of ways to install the Jira Cards add-on. I’m able to install the app, but then not able to connect my personal account. Do I need to be an admin to connect my Jira account? or did I miss some configuration?

4
D
1 year ago
Jens Thiemann
Jens ThiemannBeginner
posted in Developer platform and APIs

Best way to store user's choice/configuration

Hi,I created an app for Miro, which always users to apply some configuration.In my app, the users can change the size of cards they drag to the board.To increase the user experience, I want the user’s choice to be available when he uses the app again.I wonder what would be the best/easiest way to store the user's choice.Any ideas/proposals?-Jens-

7
Y
1 month ago
J
Jay RBeginner
posted in Developer platform and APIs

Looking for a developer to integrate Miro into our platform.

I am looking for a developer to help embed Miro within my platform. If you have experience doing this, please email me at jnt.raja@gmail.com to get started :)

3
J
1 year ago
A
Alyan SanievBeginner
posted in Developer platform and APIs

I don't understand the "Miro REST API" description

Hi.Сan you explain the meanings of the "Miro REST API" events, please? For example:account_created account_default_project_sharing_settings_changed account_invitation_settings_changed account_external_collaborators_enabled account_integration_settings_changed user_invited_to_account I think “account = team”, right?I want to understand it before using API and getting logs.Thanks!p.s. Можно на русском.

2
A
2 years ago
S
saraTomBeginner
posted in Developer platform and APIs

Call External Rest API from Miro SDK

I need to create a custom plugin to integrate Miro with my internal application. The app would push the data from Miro to the internal application. Is there any recommendation to call an external API hosted by an internal application that requires OAuth authentication?

1
Mira Balani
Mironeer
8 months ago
I
ikarstNew Here
posted in Developer platform and APIs

API access on Non-Developer-Account with "Consultant" Plan

Hi!I want to enable API access to my boards.My plan ist “Consultant”.I have another account as “Developer”. There I can create ClientID/ClientSecret.But how does this work with a “real” miro board? 

3
William Bishop
Mironeer
1 year ago
L
Lakshman Kumar KalasamudramBeginner
posted in Developer platform and APIs

How can pass user login credentials to web SDK authentication without actually passing in the pop up

I am building an application which will actually connect to Miro web SDK, give username and password, sign in, pick a board to view, embed that board in my app using Board Picker. My app will allow multiple users to access it and if a user logs in to the Miro through sdk once next time onwards the login is not needed. How can I achieve below requirement?My requirement :(Consider my app has the clientId, clientSecret, user Miro email id, User password <if needed>)User “raj” logs into my app using the email id with which he has his miro account. After login raj clicks on a button BoardPicker. It should show the boards related to raj directly without him explicitly doing the login. My app should do that login and show the boards directly to him to select and embed.  Please tell me how I can achieve this. 

2
Anthony Roux
Mironeer
1 year ago
T
Tyler SanbornBeginner
posted in Developer platform and APIs

504 on app authorization

Hello, I followed the steps here, and am trying to install the app to my dev board but getting a 504 timeout every time. I was able to solve an earlier auth issue with the trailing slash on the Redirect URI, but I’m stuck here. .env file is all updated too. Thank you for any guidance in advance!Interstitial to install appDev app URLsApp settings 

9
William Bishop
Mironeer
8 months ago
T
thedarkstrixContributor
posted in Developer platform and APIs

Toolbar missing in unregistered boards

We are using the live embed feature , when the unregistered board is loaded , the toolbar disappears automatically but the toolbar shortcuts all work (like p (PEN) etc).Not sure why the toolbar suddenly disappeared . Looking for help regarding this.What I have already tried and failed : - Reset the cache- Using different browser- Using incognito modeWhat i have made sure : - The user the owner of the board (accessToken)- The board has not gone into view only mode- The user is able to write on the board using the toolbar shortcutsBoard URL : http://miro.com/app/live-embed/uXjVMU21pXM=/?boardAccessToken=AQ8vtfd6NXt8kfwmT4b33OkxGs8149JH&autoplay=trueAdditional info : If the were to select a registered board by selecting the board by logging in, the toolbar is visible . This is issue only happens with unregistered boards as of now. This is happening in whereby as well.ScreenshotFrom our webAppScreenshot from whereby  

4
T
5 months ago
T
tran.chungNew Here
posted in Developer platform and APIs

Don't see organizations:read scope in Oauth app

Can someone tell me how to create an Oauth app that requires organizations:read scope?Or how can I access to that scope? 

5
Marco Spinello
Mironeer
3 months ago
G
Grant ForrestNew Here
posted in Developer platform and APIs

Programmatic board creation with anonymous collaboration

We’re looking to create an experience where someone can take an existing Miro board in their account, and our service can easily spin up clones of that board on-demand for individual collaborative meetings with anonymous users.Using OAuth I can get to the point of reading boards from the user’s team and even creating a ‘cloned’ board by duplicating the widgets from a selected source board. But it appears the anonymous collaborative “access links” are specific to the embedded Board Picker experience.I don’t want to force our users to manually create and pick a board for each meeting instance - the experience I want to enable is that they click ‘create room’ in our app, and a Miro board with public editing is created from the source board they selected once, instantly.Is there any way we can utilize public access links via the OAuth API programmatically in our backend instead?

1
Addison Schultz
Mironeer
1 year ago
S
SandroContributor
posted in Developer platform and APIs

Amplitude Integration not working with EU server

Dear Miro teamWe wanted to use the Amplitude integration with our EU instance (https://help.amplitude.com/hc/en-us/articles/8476297377819). Unfortunately this does not work, because the integration expect by default, that the US server will be used (which also works). Unfortunately we use the EU server with our customers. I reached out to the Amplitude forum (https://community.amplitude.com/building-and-sharing-your-analysis-58/miro-integration-not-working-with-eu-datacenter-1451?postid=4985#post4985) and I got the answer that you can change this on your end, to use the EU servers. Is there a way you can change that default behavior or tell me how I can switch myself. I reverse engineered the code a little bit and I can see that the code would be ready for using the EU servers. 

2
S
22 days ago
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

1
William Bishop
Mironeer
1 year ago
江
江國瑋New Here
asked in Developer platform and APIs

Does Miro provide an API for capturing chat room content?

Does Miro provide an API for capturing chat room content?

1
Daniela Gavidia
Mironeer
2 years ago
G
gitbleiddNew Here
posted in Developer platform and APIs

Bug with REST Update board method

Hi, hope this is the right place to feed back with an api bug report.I think there's possible a bug with https://developers.miro.com/reference/update-boardBoards updates but for some reason server returns internal error, maybe my request is incorrect.I’ve attached request and response logs without bearer token.Thanks for the support,VasilyRequest:Method: PATCH, RequestUri: 'https://api.miro.com/v2/boards/uXjVPMm5xU4%3d', Version: 1.1, Content: System.Net.Http.StringContent, Headers:{ Accept: application/json Authorization: Bearer Content-Type: application/json}{"description":"some new description","name":"Test","policy":{"permissionsPolicy":{"collaborationToolsStartAccess":"all_editors","copyAccess":"anyone","sharingAccess":"team_members_with_editing_rights"},"sharingPolicy":{"access":"view","inviteToAccountAndBoardLinkAccess":"viewer","organizationAccess":"private","teamAccess":"edit"}},"teamId":"3458764536059967553"}Response:StatusCode: 500, ReasonPhrase: 'Server Error', Version:

2
G
11 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Announcing the experimental release of Custom Actions

Custom action being toggled from the context menu for a board item.Hey, everyone!We're excited to announce the experimental release of Custom Actions for privately distributed apps in Miro. This new feature enables you to add simple actions (to your privately distributed apps) that are accessible from the context menu of a board item. With Custom Actions, you can streamline your workflows, automate repetitive tasks, and tailor Miro to fit the custom needs of you and your teams’ use cases. 🚀 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 #experimental channel on our Discord server Important!Custom actions are only supported for non-public apps that will be distributed privately via a shareable authorization link from your App Settings page. This means that apps built with custom actions will not be eligible for distributio

0
William Bishop
Mironeer
1 month ago
T
Tom DenbyBeginner
posted in Developer platform and APIs

npm run start

this is the first miro app i’ve tried to create, so im following the webinar here -  when i run npm run start  i get the following error,  npm ERR! Missing script: "start" seems like probably a basic error but i’ve not had it before on other solution i’ve developed, any ideas how to resolve it? 

6
T
4 months ago
A
Anton ShherbininBeginner
posted in Developer platform and APIs

The getSelection function does not work correctly with text

Hello.I have selected a text widget on the board (Figure 1)If you write such a code: const selection = await miro.board.getSelection();console.log(selection, 'selection');and select the widget text, then the following is output to the console:We see that the fields "content", "FontFamily" and "fontSize" are displayed incorrectly. Sometimes the widget creation date is incorrectly determined.This code does not work in my plugin and in the console. At the same time, it WORKED yesterday! In addition, the code works correctly with other widgets (for example, stickers). Why is this happening?

6
Marco Spinello
Mironeer
7 months ago
J
James PartingtonNew Here
posted in Developer platform and APIs

Getting 500 server error when uploading shapes

I am creating a table like object on a Miro board. Each object requires roughly 100 shapes. I am asynchronously sending HTTP requests to “https://api.miro.com/v2/boards/{board_id}/shapes”. I am aware that uploading shapes is level 2, so there should be a limit of 1000 items per minute. However, even when sending 1 http request per 0.1 seconds, some errors happen:Error uploading shape to miro, status code: 500{  "type" : "error",  "code" : "3.0023",  "context" : {    "boardId" : "uXjVPxuroBA="  },  "message" : "Internal error occurred",  "status" : 500} I could not find anything about error code 3.0023. My program works 100% okay if I wait 1 second per http request, any ideas what is causing this?

4
Mira Balani
Mironeer
5 months ago
J
Joseph LowBeginner
asked in Developer platform and APIs

Batch API Requests

Hi all! I'm building an app which has to write a few hundred post its to a board at once. However, it's quite slow now as I have to make the POST requests many times in sequence rather than as one big batch. Could I ask if there are any suggestions to overcome this? I tried search but couldn't find any information on a batch request functionality. Thanks. Cheers!

3
S
7 months ago
gavin032
gavin032Contributor
posted in Developer platform and APIs

Detect Pre-selected widgets when plug-in loads

Hello!I am developing a plugin that can be opened from the Miro board. When my plug-in starts, it doesn’t check if widgets are already selected. I need the plugin to be able to detect what is currently selected when it is opened in order to improve the user experience.Has anyone figured out how to do this?Here is a video demo of the issue: 

6
gavin032
1 year ago
K
Kelly TresslarNew Here
posted in Developer platform and APIs

Drag, Drop and Delete

Hello,I cannot drag, drop or delete any of my user stories.  Can this be an access issue or a bug issue? Thanks,Kelly

3
K
1 year ago
A
Atanas KolevBeginner
asked in Developer platform and APIs

Reason is platformApplicationNotFound

I am getting the following error when i am trying to integrate MIRO board.miroBoardsPicker.open({ windowRef: windowRef, //Provide opened window reference clientId: miroClientId, // ask the backend action: "access-link", allowCreateAnonymousBoards: true, //2) Enable this option getToken: () => getMiroJWT(), // Provide token in async way success: data => { console.log("on success", data); document.querySelector("#test").innerHTML = data.embedHtml; }, error: e => { console.log("on error", e); }, cancel: () => { console.log("on cancel"); }, });getMiroJWT() returns a promise. And the windowRef works but it says “Sorry, integration is unavailable.” . The exact error message from the console log is“ on error Application key: **********. Reason is platformApplicationNotFound “ I could not find anything about platformApplicationNotFoun

2
A
2 years ago
Terms & Conditions