Developer platform and APIs

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

  • 881 Topics
  • 2,791 Replies

881 Topics

J
Jane OrmeNew Here
asked in Developer platform and APIs

Board picture API - no content

I’m trying to get a board picture using the API: https://developers.miro.com/reference#get-picture however when I enter the “boards” value and the correct board ID (checked separately using the get boards url) I get nothing returned. The example says that the following should be returned: { "type": "picture", "imageUrl": "https://r.miro.com/1234567890/0987654321/1234/4/1/size210.jpg", "id": "3074345367401345438" }   so why am I getting a 204 no content response?

1
Boris Borodyansky
Mironeer
3 years ago
K
Kingsley ChanBeginner
asked in Developer platform and APIs

return menu items with promise in getWidgetMenuItems

Hi,   I am trying to make a request to our server before returning the context menu in `getWidgetMenuItems` method. But the context menu not showing correctly when any delay occurs (even if I create a promise with settimeout for 10 ms). The context menu items may not able to display when I click on an item within the board. If I remove the settimeout, the context menu items will show correctly.   Something like this: getWidgetMenuItems: async (widgets, editMode) => {   const promise = new Promise((resolve, reject) => {     setTimeout(() => {       resolve([         {           tooltip: 'Tools',           svgIcon: 'svg-icon',           onClick: async() => {             // on click event           }         }       ]);     }, 10);   });   const result = await promise;   return Promise.resolve(result); }   Regards,  K

1
Ahmed El Gabri
Mironeer
3 years ago
V
Vladimir MakayevNew Here
asked in Developer platform and APIs

API to track cards on Kanban Board

I was looking into building a plugin (Web or via REST both options are on the table) that tracks dates when cards are being moved around on the Kanban board. It looks like I can save some custom data under “metadata” : “app_id” { … } but I couldn’t find the way to query which column does the card belong. Is there a way in JavaScript or in Rest API to query which column does the card belong to on the board?

5
C
4 months ago
Steve Appling
Steve ApplingBeginner
asked in Developer platform and APIs

Trouble using app outside of developer team

I’ve created an app and tested it in my dev team.  Now I want to use it on my real team with other users.  From step one here, it looks like I should be able to use the “Install app and get OAuth Token” button to get an accessToken.  While I was able to get one that works on the board in my dev team, it doesn’t seem to work for boards in my real team.  If I go to the “API, SDK & Embed” tab of my profile, I see my test app listed associated with a team of “Dev team”.   I can’t seem to edit this to associate it with another team.  If I try to create a new app, it only lets me pick the Dev team. How can I use this app I created with a real team?  It’s a command line tool, so I don’t think I can participate in an OAuth flow.  It’s not running from a web site.

1
Boris Borodyansky
Mironeer
3 years ago
Steve Appling
Steve ApplingBeginner
asked in Developer platform and APIs

Setting Color through REST API

I’m trying to set the color of a sticker using the REST API, but not having much luck.  When I set style.backgroundColor to any value other than “#fff9b1” I get an result of error code 400 (Bad Request).  Are there only certain allowed values?  Could these be specified in the documentation?

6
J
2 years ago
Steve Appling
Steve ApplingBeginner
asked in Developer platform and APIs

Positioning content in parent frame

I’m using the REST API to try to add stickies to a frame, similar to the GitHub Issue Importer example.  I find that if I specify a parentFrameId, that the x and y position is ignored and the sticky is added to the center of the frame.  If I don’t specify a parentFrameId and give an x and y, then I can position them, but they aren’t considered children of the frame unless I go into the board manually and wiggle the stickies.   How can I put content into a frame and not have it all stacked on top of each other?  Also, I couldn’t find documentation for the parentFrameId in your API documentation.  It is only mentioned in the example.

1
farbodsaraf
Mironeer
3 years ago
R
Rajat JainNew Here
asked in Developer platform and APIs

APIs to get all users and licenses in a company not just in a team ?

How I can create an integration such that I can pull all users and licenses for all the team. Or How to pull all the team ids first such that I can pull all users for each team id ?

1
S
Mironeer
3 years ago
J
JohnQRNew Here
posted in Developer platform and APIs

Feature request for release of Notion.so API

Hello!   I would like to put forward a topic (and request) about creating a live diagram from a Notion instance in Miro, once the Notion API finally is released (and which we have no details on I realize...). What I’d like to accomplish is visualize all my relationships in Notion “live” in Miro via API.  I have experimented with Jira and Asana cards, but neither take into account relationships at all.  I’d use this to visualize my website and dev platform, ERD-type stuff, server config, etc.  The bonus I’m looking for is as I build this in Notion, and adjust relationships, this would all update automatically in Miro.  So I would solve the huge problem of diagramming in Miro, but then being left with the diagram being almost instantly out-of-date due to work being done in Notion that has to be represented on the fly in the Miro Diagram. I have thought about the same thing in Coda already, as they have an API live.  If anybody has any thoughts here I’d greatly appreciate it. I actua

4
S
3 years ago
C
Chris MarquesNew Here
asked in Developer platform and APIs

Mindmap meets spreadsheet

Hi Everyone,   I really enjoy using Miro, although there is one thing that I do often and rather than using various apps would love to do within Miro. everything starts with a mindmap for me, but early on in the process I need to run basic simulations and would love the ability to use a cell within a shape as spreadsheet cell ( ie be able to enter basic formulas to then see the impact on the whole project of funnel )   For a simple example    top node has a title and a cell which is a variable ( eg invoice amount in ) a few child nodes have each a title and a cell which i assign a formula ( show 15% of top node here ) finally child node with resulting profit   etc   is this doable ?

11
Anthony Roux
Mironeer
2 years ago
S
Siddhant KumarNew Here
asked in Developer platform and APIs

Sorry, integration is unavailable.

When i tring to use  this is code miroBoardsPicker.open({ clientId: '***********', // Replace it with your app ClientId action: actionSelect.value, success: (data) => { resultsBox.innerHTML = JSON.stringify(data, null, 4) resultsBox.style.display = "block" } }) it is giving me error in console Error. Account is not a partner. Reason is accountIsNotPlatformPartner   and on chrome popup Sorry, integration is unavailable.

13
Boris Borodyansky
Mironeer
1 year ago
A
Anna HolovchenkoNew Here
posted in Developer platform and APIs

Mixpanel & Miro integration

Is there any possibility to import/integrate Mixpanel Dashboards into Miro dashboard?

4
C
1 year ago
F
Ferris440New Here
asked in Developer platform and APIs

Manipulation only - no new board elements?

Hi community, I’m keen to experiment with extending the Miro board with other apps that can be dropped onto the board and used by the team. E.g. and embedded version of Figma, a file store or a coding environment. I can’t use the iFrame widget for this as it defaults to just showing a preview - I want it to show the actual content of the remote session (likely with some kind of user locking mechanism). Am I correct in my understanding however that the widgets/API can only be used to create apps that manipulate existing board items (e.g. place post its) vs create new board entities (e.g. premium post it). Thanks for your help! Luke

3
T
3 years ago
C
Craig HardcastleBeginner
asked in Developer platform and APIs

Widget Dimensions

When retrieving all the widgets for a board, you appear to get the x and y but the width and height is not set or is missing. For assets like the AWS icons there isn’t even a reference to the icon being used for the widget that I can see? I am trying to create a tool that will update the board by placing tickets around a given widget on the board. I have done this fine with Draw.io because the position and dimensions of each object is available, but with the miro api those values appear to be missing? Hopefully this is just user error and any guidance would be appreciated 

3
C
3 years ago
T
tahsin can sarlakNew Here
asked in Developer platform and APIs

Creating a board using p5.js / javascript

Hello,   I would like to create a board using a p5.js program I am developing. It takes JavaScript. However, when I copy paste the code Miro generates, it returns null, where as it should have returned me an object. I tried the other languages and they work fine. Although, I need the JavaScript working.   Could someone please help me?   PS. I tried both fetch and xhr

1
Viktor Dolhishev
Mironeer
3 years ago
S
saifisBeginner
asked in Developer platform and APIs

The customization possibilties for cards

I've looked around  the references and know to customize a lot of things like adding logos and such, but still aren’t sure if I can change the height and width or add tags to the cards via web SDK   If there is a page somewhere I can look at to figure out the details of the card object creation?

4
D
1 year ago
D
David StubbinsNew Here
posted in Developer platform and APIs

JIRA and Planning Poker Integration

Good morning. I am trying to find out about the level of integration Miro has with JIRA and planning poker, specifically as to how much can be automated e.g. pulling in stories that are of a certain status, point a story, then automatically update the relevant JIRA story with the relevant number of points. I’ve seen there is JIRA cards integration, but my question, is that in using planning poker, would there still be a manual element to pick the stories from JIRA that need to be pointed, and once the pointing has occurred, we would then need to manually update the JIRA story by clicking on its card? Anybody have any experience with the JIRA integration that would be able to answer this one? Many thanks

1
Boris Borodyansky
Mironeer
3 years ago
K
Kingsley ChanBeginner
asked in Developer platform and APIs

Frame widget's metadata doesn't presist

I have programetically created a Frame widget with metadata ``` [appId]: {   type: ‘type’,   id: ‘AAAA’,   latestVersion,   majorVersion,   minorVersion,   statusVersion, }, ``` The metadata exists when the frame is created, but after I back to the board listing page and go back to the board, all the metadata in the frame are gone. The metadata are presist in Text widgets and Image widgets, but Frame widgets has this weird behaviour.   Regards,  K

4
C
3 years ago
E
esenNew Here
asked in Developer platform and APIs

LTI integration with a LMS

Hello, has anyone integrated MIRO with a learning management system so MIRO whiteboards can be used within a learning management system? Thanks!  

3
P
2 years ago
J
Jason BougasBeginner
asked in Developer platform and APIs

Is it possible to use an OData connector to extract data from the Miro API?

I am trying to connect to the API using OData and am unsure if this is available in Miro or whether only REST API is available.  Anyone done this?  I’d like to get the data for a board into Power BI.

2
farbodsaraf
Mironeer
3 years ago
G
Gerald DunnNew Here
asked in Developer platform and APIs

Deriving Structure Metadata from API Widget

If i use the API to query a widget on a Kanban board, I get an X and Y co-ordinate, but I don’t seem to see any reference to the structure of the board itself eg Swimlane/Bucket name or indeed the fact that the widget is contained within a particular swimlane/column. Am I missing something.  Is there some API call that allows me to further discover the structure and relationship between widgets?

7
S
3 months ago
G
Georgiy EfremovNew Here
posted in Developer platform and APIs

Does any know how to export miro board as any structure with information about objects on it?

Hey guys.  I have a tree in my miro board. Structure is simple:  nodes are text, connection between - arrows.  I know that there is option to export information as csv but this is works only for text.  Is any ability to export informations about arrows(connections)? (any structure)  Many thanks

2
K
2 years ago
N
nick bogaertNew Here
asked in Developer platform and APIs

Company Templates feature on consulting plan

We are on a consulting plan and create a team for every client we work with. We recently put a lot of effort into creating miro templates for all our tools to realize that we have to add these to every team separately. This is not only a lot of unnecessary work every team we add a new client, it also means that we can’t change our templates centrally. The current workaround - copy pasting templates from our company team into boards for client teams -is time consuming and creates a lot of clutter in the form on unused boards on our company team. The feature to make this accessible across team accounts already exist on the enterprise plan. Given the nature of most organizations that are on the consulting plan it would make a lot of sense to add it to the consulting plan as well!

2
Dominique Rolink
Mironeer
2 years ago
Vladislav Khodchenkov
Vladislav KhodchenkovBeginner
posted in Developer platform and APIs

Custom Plugin - StickerMan

Surely you have already seen the new "auto-layout" function, I think you liked it. Of course, this new button is really needed, but our small team of programmers has got an idea. We want to make a plugin for Miro users, which adds a new function to make an excellent looking Miro board in a few clicks. After great creative work, you've got a mess all over the board, but we have a solution for it, u can group stickers by any signs (color, size, etc.). The plugin we're working add a "magic wand" button, all u need is just choose stickers u need to group and press the button. U will get an imposing result. What do you think about our idea? Maybe you suggest some options for grouping?

2
Jakob
3 years ago
D
David BovillNew Here
asked in Developer platform and APIs

API Roadmap - ie for other widget types (preview)

There are currently only a few limited type of widgets that the REST API is able to create. I need to create preview type widgets in particular - and they are read only. Is there any type of roadmap, for the API? I’d like to have some idea what is on the priority list in terms of new features to the API in the future? Is there another way to pre-populate a Miro Board with a map of preview objects linked to cards?

1
S
Mironeer
3 years ago
E
EgorNew Here
asked in Developer platform and APIs

Undo working result of the plugin

Hello! I am plugin developer and i want to do feature which allows user undo working result of my plugin, i can do this in entries of my plugin but will be cool if i integrate this into miro undo\redo functionality, so can i achieve this or this is impossible?  

1
S
Mironeer
3 years ago
Terms & Conditions