Developer platform and APIs

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

  • 710 Topics
  • 2,351 Replies

710 Topics

V
Vladimir B.Contributor
posted in Developer platform and APIs

Change app title dynamically inside code

Hey Miro Developers and Miro Community The app I’m developing (Miro SDK, React.js project) has multiple screens and I would like to change the app’s title, according to the selected screen.Sadly, there seems to be no option for that in the miro sdk, since the title is always chosen from the app settings.My first idea was to access and change the title via parent.document, since it worked out in the browser web tools, but this has some permission issues.Uncaught DOMException: Permission denied to access property "document" on cross-origin objectNow I am wondering, did I miss something?Is there a way from the REST API or the Miro SDK? Or is there some other workarounds to access the title outside the iframe? Best RegardsVladimir

4
Mettin
Mironeer
3 months ago
P
PDunnBeginner
posted in Developer platform and APIs

Color picker reduced colors available

I am only seeing the standard 16 colors, but in the past had a large amount of colors. If my account changed do these colors go away that I set up?

4
P
3 months ago
N
Nikhil SachdevaBeginner
posted in Developer platform and APIs

Miro Board picker not working

Miro board picker is throwing a blank screen as per the screenshot for the last ~30 minutes. Is there any recent config update because of which this isn’t working. Kindly update the miro board picker screen with error states in case it doesn’t work for better troubleshooting. 

4
N
3 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
3 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
3 months ago
S
Sara tomBeginner
posted in Developer platform and APIs

Miro – Create actionable link in a frame

Hello,  Is there a way to create an actionable link in a frame? I am trying to create the links using Web SDK? I would like to create this action in the top corner of the frame, If there are items, I would like to push the items to any, and add the link ThanksSara

6
Marco Spinello
Mironeer
3 months ago
M
Michael SchiebenBeginner
posted in Developer platform and APIs

Buggy positioning behaviour, after using frame.add() in Web SDK v2

Hi there,I’m currently  trying  to migrate the Field plugin to Web SDK v2 and having trouble to position Sticky Notes in a Frame once I have added the Sticky Note as a Child using the frame->add() method.I have created a simple example on a freshly created Board to demonstrate the unexpected behavior. I recorded a little loom video. Please have a look at what I am doing in the web developer toolbar. It’s wired, that the Sticky Note is displayed outside the frame. I would love to get some help here: What am I missing? Team Miro - can someone please point me to a working example, where a Sticky Note is first added to a frame, and then positioned inside the frame?Thanks in advance! 

4
M
3 months ago
A
ArnauNew Here
posted in Developer platform and APIs

npx create-miro-app fails

npx create-miro-app@latest crashes with the following error: Unexpected error. Report it as a bug, so we can look into it:                        TypeError: t.replaceAll is not a function It doesn't depends on the options I choose, it fails all the time. I am using Node version 14.21.1 and NPM version 6.14.17 on Ubuntu 22. I tried different create-miro-app versions and 1.8.0 is the most recent that works.

4
Mettin
Mironeer
4 months ago
V
Victor64100New Here
posted in Developer platform and APIs

Iframe background,modyfing

Hi ,With this code i cant set a background ,<iframe src="https://app.databox.com/datawall/e8c95f383a6cf2d526f95b28487bc5d" width="1280" height="720" frameborder="0"></iframe><style>body{  background-image: url('https://i.goopics.net/kxekcg.jpg');  background-repeat: no-repeat;  background-size: cover;}</style> Someone already find out something or miro is just not friendly with iframe background ?  My goal is to replace the image that Miro gives when you put an iframe code .  Thanks .  

2
Marco Spinello
Mironeer
4 months ago
M
MJ PetroniBeginner
posted in Developer platform and APIs

bug(ish): creating a card widget using Zapier asks for a hex color, but requires # and that is not documented

Hi there. Was dumbfounded for a while when setting up an airtable → miro card widget Zap in zapier. Setting card color is possible, but requires the hex color code to have a preceding #. That’s fine, but it’s not documented in an easily-accessible way outside of the API docs and not all apps require it. The Miro docs are a bit obtuse for non-developer pro users, and the error returned via zapier was just ‘method argument.’ Searching for that in the API docs didn’t lead me anywhere. Digging around and reading carefully, noticed the need for #, but I recommend making more verbose error codes or being clear about data validation requirements somehow. 400-Bad Request did not make it clear. Thanks for considering.  

1
Mira Balani
Mironeer
4 months ago
C
CigeyoBeginner
posted in Developer platform and APIs

Do we need to have paid account to keep oAuth app?

Hi, We developed an oAuth integration and other miro users already using it. We want switch to free account, but we are not sure our oAuth app integration will be still available in the app market. Some platforms could remove free accounts after some time.

1
Will Bishop
Mironeer
4 months ago
Carola Wenk
Carola WenkBeginner
posted in Developer platform and APIs

Use Rest API to get a list of board member names (in project) ?

Hello. I am the owner of a team (on an education account) and would like to list the *names* of the people who have created or modified items on one of my boards in my team.Setup: The board is inside a project (= folder), I am the board owner, and three other users are part of the project and therefore have access to the board and have edited it.Problem 1: The Rest API v2 only lists items with user IDs (not names anymore, as it did in v1). I need the names for those users.Problem 2 (potential bug): Rest API v2 user-connections query is supposed to return all board members, but it only lists myself, not the other three users who have access to the board and have already edited it. Shouldn't they also be board members?Problem 3: It looks like with an education account I don't have access to the “list team members” functionality. Any ideas? I have the user IDs of my team members and I need to map them to names.

10
Carola Wenk
4 months ago
V
vp_appgamiBeginner
posted in Developer platform and APIs

Serious regression with API v1

Hi there,Some time ago we have found a regression on the SDK v1 that is blocking the usage of our Miro extension "Smart Diagrams". The extension essentially provides a list of pre-built Miro diagrams that can be added to your board, saving time when creating nice-looking boards.However, since a couple of months ago, when users choose a diagram to add to the board it gets added normally, but then if they resize it, all shapes are transformed into squares! This breaks the whole user experience and it's a blocker for users to continue using our extension. Here's a video showing the problem:  I've been in touch with some people from Miro, who confirmed that they could reproduce the problem, but I've never heard back nor this has been fixed. So I'm hoping that the community can help and hopefully the Miro folks can get back to us.Does anyone else have this issue as well? Miro, please help! We are stuck!Thank you. P.S: we tried moving to the SDK v2 but there are many missing forms and attrib

3
V
4 months ago
M
Michael BlackwellNew Here
posted in Developer platform and APIs

Cluster as a voting filter

Would be great:  Making Cluster one of the artifacts available for vote filtering.Would be really, really, great: Users do not vote for individual items within a cluster, they vote for the cluster itself.

1
Marco Spinello
Mironeer
4 months ago
E
EranNew Here
posted in Developer platform and APIs

Get installed user applications via API

Is it possible to get installed user applications via the RestAPI?I want to be able to list all app tokens for each of my organization users.

1
Will Bishop
Mironeer
4 months ago
D
Dave SkuraNew Here
posted in Developer platform and APIs

rest api to read content of stencil

Hello, I want to read the ERD template to produce a DDL, but can’t figure out how to read text/content from stencil type.  can anyone help ? thx,Dave

3
Mira Balani
Mironeer
4 months ago
Wiktor Zurawik
Wiktor ZurawikNew Here
posted in Developer platform and APIs

Miro REST API endpoint does not return all card data

Hello all!I’m playing around with Miro’s API and I encountered one issue that may be a bug (or not, fingers crossed :)). I created a board on which I placed a couple of cards. Each card has a title, me assigned to it and due dates set.I query the https://api.miro.com/v2/boards/{board_id}/cards/{item_id} endpoint but it does not seem to return the full data on specified cards. Within the data field I get the assigneeId, description and title properties but dueDate is always missing. So essentially from this:I get that: Is someone familiar with the issue? I may be missing something here. 🤔Cheers!Wiktor

8
B
4 months ago
S
Stephen WingertBeginner
posted in Developer platform and APIs

Rest API - Boards does not return last opened attributes

The “boards” rest API returns a number of attributes including “createdAt”, “createdBy”, “modifiedAt”, and “modifiedBy”. Is there a way to get the “last_opened” attributes? One can sort the results by “last_opened” date, but the details on the “last_opened” event are not returned e.g., “lastopenedAt” and “lastopenedBy”.I am building a solution to delete boards that have not been used within a set time period. I would like to include both the last opened and last modified dates into my deletion criteria.

3
S
4 months ago
S
saraTomBeginner
posted in Developer platform and APIs

App Integration -- name value pair/tabular data

I have a use case where users would create handoff sheets in Miro. So they might add a section that contains some form data field name/value pair.Name  XXXX Company YYYY      I understand the tabular data cannot be pulled via App integration..  What is the best way for the user to enter a name/value pair so that the Rest API can pull the data? I would like to see if there is an elegant way for users to input the data and ihe API can map the name-value pairs.

1
Max Harper
4 months ago
P
PeiliNew Here
posted in Developer platform and APIs

Regression Boards Picker

Since this morning the Miro Picker doesn’t work anymore:picker.248f8f1cbcc61993.js:2 Failed to execute 'postMessage' on 'DOMWindow': The target origin provided ('https://www.company.url') does not match the recipient window's origin ('https://miro.com').

3
Will Bishop
Mironeer
4 months ago
B
Bill GallagherBeginner
posted in Developer platform and APIs

How to find the age or validity of an access_ or refresh_token

I’m looking for how to find the age or time left on a token. I can call https://api.miro.com/v1/oauth-token with the access_token in the header as a Bearer token. Works great, tells me it’s "type" : "oAuthToken" and other info, but it doesn’t tell me how long I might have left on it. I’d also like to know whether a given token is a refresh token, but when I use the same pattern as above with the refresh_token in the header as a Bearer token, it doesn’t work. I get that it shouldn’t because refresh!=access, but is there any way to get more info about a refresh token? The other option is to always refresh and not care how much time is left, but that feels excessive. While you’re here, can anyone tell me the difference between the /oauth-token and /oauth/token paths?Thanks all! 

2
B
4 months ago
R
Richard121212Beginner
asked in Developer platform and APIs

REST API how to handle boards with more then 1000 widgets?

HiWe have a board which is bigger then 1000 widgets. The List Widget (https://developers.miro.com/reference#get-board-widgets-1) has a limit of 1000. We tried the option to use the filteroption and get only the FRAMES and then load all the children by the https://developers.miro.com/reference#get-board-widget But.. (as expected) we get the   "message" : "Request rate limit exceed",   We can put more time for calling the 1000+ times on the webservice, but that does not seem ideally. But maybe there is an other way? As an idea… Is it possible to add a REST service, which can get multiple Widgets by multiple ids?  So as a parameter a list of Ids to get from the boar? Best regards,

21
Marco Spinello
Mironeer
4 months ago
C
Chris EigensonneNew Here
posted in Developer platform and APIs

Error code API connect to Torii

Hello, since 2 days we are getting an error if we are trying to connect Miro to Torii to automatically manage Users and licensesError: Failed to request authorization for application 3074457365632507822 in team 3458764516327583199 Can you pls let us know how to solve that issue=?thanks Chris 

2
C
4 months ago
J
Joseph LowBeginner
posted in Developer platform and APIs

How to make a sidebar plugin, rather than a pop-up plugin

Hey all, I’m working on developing a Miro plugin and would like to find out how I can make my plugin take up the sidebar, rather than opening up as a pop-up. I’ve attached a screenshot of the difference between the sidebar and pop-up plugins which I am referring to (Let me know if there is a correct way to name these!). The documentation only has openPanel and openModal which do not work for me. Any help would be much appreciated!  Cheers!  BoardUI DocumentationSidebar PluginPop-up Plugin 

11
Will Bishop
Mironeer
4 months ago
J
Justin FenechBeginner
asked in Developer platform and APIs

Custom menu on Widget Bar

Forgive me for using incorrect terminology as I have just started digging into this.I understand how to add a custom icon to the widget menu bar and am able to show a modal, however I would like to instead make my icon display a “dropdown-like” menu instead. Much like the functionality of the tags or assignee dropdowns. Is this possible?Thanks,Justin

4
T
4 months ago
Terms & Conditions