Skip to main content

Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development. See documentation at <a href="https://developers.miro.com/docs">developers.miro.com</a>

  • 971 Topics
  • 3,077 Replies
971 Topics
A
Andreanne DroletNew Here
asked in Developer platform and APIs
board on app not loading

All board on app not loading but work in browser.

191
Robert Johnson
8 months ago
A
Andrea ScalabrinNew Here
posted in Developer platform and APIs
Unpredictable results from GetBoards REST API

Good afternoon,I am trying to call the REST API manually for testing purposes, but I noticed that I get unpredictable results. I currently have 3 boards. Board TEST 3 was just created moments ago.However, the API returns that there are only 2 boards available. I have run this directly on the documentation sandbox to make sure the problem wasn’t with my calls. I still get consistent results and the board TEST 3 is not present in the JSON response.All three boards have read/write permission with the Developer team that I created for this testing purpose, so they are accessible (or they should be). At some point and after trying the GET request several times, without changing anything with the boards (I think I’ll be waiting for something like a couple minutes), the third board will appear.Deleting a board seems to have an instantaneous change within the database, therefore if I call the API after deleting a board, it will disappear at the following API call. However, trying to re-add a b

240
A
8 months ago
G
Geir ØlnesBeginner
posted in Developer platform and APIs
Syntax for attaching metadata to a shape using API

HiI am trying to attach metadata to a shape widget created from javascript through the API.Widget is created correctly when there is no metadata, but creation fails as soon as metadata is part of the widget definition. I have interpreted the metadata definition from this post:https://community.miro.com/developer-platform-and-apis-57/how-to-attach-meta-data-via-webplugins-682and from the documentation here:https://developers.miro.com/reference/application-metadataThe result looks like this:    let shapeWidgets2 = await miro.board.widgets.create([        {            type: 'shape',            x: x3,            y: y3 + 150,            height: 30,            metadata: {                ['TEST']: {                    'type': 'sannsynlig',                },            },        },    ]) I have tried several combination with and without aphostrophes, but none of them works.Can anyone out there give me a hint on what is wrong with the code?

38015
A
Mironeer
8 months ago
V
Vincent NeveuxNew Here
posted in Developer platform and APIs
Extracting data (from several boards ) towards a single place

Hello !I've been using Miro for several years and many projects (30+). I love it, it's a great tool that really helps me thinking. But the downside is that, along the way, all my work has been stored on several different boards through various architectures.Lately, I've been wanting to grab all that "data" and to gather it in a singular place. I want it to be easier for me to cruise between my past projects, to centralise all their output. My goal is clarity and readability. The data in itself is mostly text but, as you can guess, with a precise visual organization also.By any chance, would any of you have an idea or a recommandation?I'm looking for a technique to "extract" the data, but also for a way to could store it visually in a convenient way.Thanks in advance, and have a great day :)

691
Elena Ignatik
Mironeer
9 months 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?

18677
S
9 months ago
A
Allison KelseyBeginner
posted in Developer platform and APIs
Miro Trigger in Zapier

I would like to set up an automation between Miro and ProductPlan using Zapier. Trigger: Sticky added to a Miro boardAction: Add contents to ProductPlan roadmap parking lot Unfortunately Zapier informs that only Miro actions are available.

551
K
Mironeer
9 months ago
Daniel Fosco
Mironeer
Daniel FoscoMironeer
posted in Developer platform and APIs
Mirotone UI Changelog

This topic is the changelog for the Mirotone UI Library, the official design resource for Mirotone CSS. For feedback or questions, check the announcement post for the library, or leave a message on our Discord server. 📣 Subscribe to this post and get updates in your inbox whenever a new version is released 📣  Version 1.2 Initial release of the Mirotone UI Library: Adds Foundations Colors Functional Colors Typography Spacing Effects Spacing Radius   Adds Icons People icons Objects Symbols Board objects 16x16 icons 32x32 icons   Adds components App Panel App Card Inputs &amp; Checkboxes Select Buttons Divider Dismissible Badge Link Tags Tabs Table Tooltip   Adds Utilities Canvas utilities Installation flows  

1382
William Bishop
Mironeer
9 months ago
Anastasia Lebedeva
Anastasia LebedevaBeginner
posted in Developer platform and APIs
Interaction with cursors

How cool would it be if in Miro you could not only see the cursors of other participants, but also INTERACT WITH THEM? For example, a dear colleague or an inquisitive session participant is swimming next to you, and you can click on him and virtually hug/smack/put a heart❤️? I think such an option would add soulfulness to any collaboration.And for purely formal and serious interaction, you can provide an option at the top next to the avatars to disable this function (similar to the Hide Collaborators' Cursors button).

541
Horea Porutiu
Mironeer
9 months ago
R
Ravikiran MajjiBeginner
posted in Developer platform and APIs
Any API to remove user licenses or remove users from MIRO Teams?

Hi, Do we have any API to remove the user licenses or remove users from MIRO team? I can see API to invite users but not able to find option to delete.I referred the documentation and delete apis are deprecated. Please confirm if any API is available to do this task. Thanks, 

103714
Horea Porutiu
Mironeer
9 months ago
S
Siddharth VaishnavNew Here
posted in Developer platform and APIs
How can i get the list of users from every boards using miro api

Is there any way to get the users list from every boards associated with team under single api only as I cannot call the multiple api in my workflow based on the board api I am using auth0 to authenticate the users

601
Horea Porutiu
Mironeer
9 months ago
roberrtt.1211
roberrtt.1211New Here
asked in Developer platform and APIs
From Where Should I Begin?

Hello, all!This is my first post after just joining this discussion, so please forgive me and provide kind assistance if I have posted to the wrong subsection.I am new here but a real enthusiast and loving this community so far. I have a background in teaching coding and in education and feel I could help with documentation, at least for starters.As a new member in this forum and wish to share and gain some knowledge. I am looking forward to create my own discussion to resolve my query and gain some knowledge though I have taken part in various discussion which is definitely helped me a lot.Also what category should be taken depends on what factors? Thankyou in advance.

271
Horea Porutiu
Mironeer
9 months ago
M
MeganmmmmmmmmNew Here
posted in Developer platform and APIs
Infinite Loading

Same issue as a ton of other people...can’t get Miro to load anything (no dashboard, no boards) even after attempting to troubleshoot in all the ways.This really sucks Miro team.  You’re likely to lose someone who used to really love your software. 

490
M
9 months ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
New resources for storage, events, and collaborative apps in the Web SDK

Hey, developers!We’re happy to share a couple of new resources you may find helpful when working with the Web SDK.❓Some of you have had questions around events, and if there is a single page where you can find all events related to the Web SDK. Also, we've heard questions around what the difference is between metadata and storage, and when to use one over the other.So we've created comparison tables you can use to help you decide which feature may best fit your use case.Comparison tables:Events: https://developers.miro.com/docs/events Storage &amp; Metadata: https://developers.miro.com/docs/storage👥 We've also created a guide on helping you understand collaborative experiences that can be built via the WebSDK.These can be useful to create an app in which you want to emulate a workshop, or to create different experiences for a facilitator and their participants. Read our guide on how to build collaborative app experiences here:Build Collaborative App ExperiencesCheers!Miro Developer Pl

300
William Bishop
Mironeer
10 months ago
I
IBCNew Here
posted in Developer platform and APIs
REST API, Update Frame Width or Height returns Child outside parent error

curl --request PATCH \ --url https://api.miro.com/v2/boards/&lt;Board ID&gt;/frames/&lt;Frame ID&gt; \ --header 'accept: application/json' \ --header 'authorization: Bearer &lt;Redacted&gt;' \ --header 'content-type: application/json' \ --data '{ "geometry": { "width": 900 }}'Returns a error, no matter what I give it,{ "type": "error", "code": "3.0204", "context": { "boardId": "&lt;Redacted&gt;", "itemId": "&lt;Redacted&gt;" }, "message": "Child item cannot be placed outside the bounds of its parent", "status": 400} Why does this happen, I did not even update my position, even if I give my old positions, I still get the same error all the time. This is very frustrating and disappointing.

260
I
10 months ago
J
Junhyeok ChoiNew Here
posted in Developer platform and APIs
How to move Widget's X,Y coordinate via Web SDK

How to move it? async function addSticky() {myItem = await miro.board.createStickyNote({content: 'Web SDK test!',});} async function moveRight() {myItem.x += 10;}is it possible to move throught WEB SDK?

831
William Bishop
Mironeer
10 months ago
I
IdeateplusNew Here
posted in Developer platform and APIs
Problem: I want to copy board from one account to another team account via Miro REST API.

Hi @Miro Developer Relations I am trying to copy board from one account to another team account via Miro REST API. I tried two approaches to solve this problem see below:Approach 1: I used copy Board API but getting 403 Forbidden error if i am using v2.0 API.Approach 2:1. I created blank board to other team member account via Create Board API.2. I get all widgets from one board which is exist into another team account via List All Widgets API via v1.0 API.3. I tried to create all widgets into newly created board but getting error like fontFamily key or createAt,createdBy is not supported into rawJSON  via v1.0 API.So i am stuck into that please suggest the solutions of above problem which i am facing at my end.Thanks. 

1263
Josip Janzic
Mironeer
10 months ago
S
StussyNew Here
posted in Developer platform and APIs
How to get the image URL using MiroAPI or SDK

 I'm currently trying to get images on the Miro board using MiroAPI or SDK. However, when you run the code below, nothing is displayed in the URL field. What should I do? What I want to do is get the image on the Miro board and paste it into my web application via the server, and one way to do that is to use a URL. I would like to know if there is another method.–const allWidgets = await miro.board.get();    const imageWidgets = allWidgets.filter(widget =&gt; widget.type === 'image');    const imageData = imageWidgets.map(image =&gt; {        return {            id: image.id,            url: image.url,             title: image.title,            position: image.bounds         };    });  console.log(imageData); 

690
S
10 months ago
S
Soren NielsenNew Here
posted in Developer platform and APIs
Stop opening miro in my browser.

Every time I get a link to a miro board the link opens in my browser. Stop doing that! I have the desktop app installed. Open the miro board in the app.!!

460
S
10 months 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?

12545
C
10 months ago
L
Laszlo TorokNew Here
posted in Developer platform and APIs
Include Miro boards of an organisation in federated full-text search

Hi,we have a fairly large organisation and we create content on multiple platforms (Confluence, Github, GDrive, Miro). We are currently building a federated search application to allow our employees to search across all relevant content repositories.We currently index content on Github, Confluence and would like to add content in our Miro org to our index. Is there some sort of API Miro offers to allow external search indexing bots to index their content, or perhaps something more specific to Elasticsearch, since it is the technology we happen to use?

1282
Mettin
Mironeer
10 months ago
Ronny Roeller
Ronny RoellerBeginner
posted in Developer platform and APIs
OAuth endpoint returns expired access token

For our app (3074457347393893408; status “Draft”), we go through the OAuth flow, and receive an access token.Yet, the token is expired: “expires_at” is the current timestamp and “expires_in” is set to 0. We also don’t receive a refresh_token.Interestingly, the option “Expire user authorization token” is deactivated in the admin UI.Do you have any advice what might cause this? 

231
Ronny Roeller
10 months ago
N
noam.arbelNew Here
asked in Developer platform and APIs
Be able to show/hide shapes

Hello,I would like to have a way to hide and show shapes. This will allow to write an app for something like layering. I tried moving a shape into x=Number.maxNumber, which was good, as it was off the visible board, but then I get an error when I try to set it X value back to its original value. Something like it has no parent.Any other ideas on how to do this?  Thanks.

1403
Mettin
Mironeer
10 months ago
Richard Watts-Seale
Richard Watts-SealeNew Here
asked in Developer platform and APIs
Export table data through the API

Is it possible to export table data, including the contents of each cell, using either the web SDK or REST API? I can see it is possible through the UI but I can’t figure out a way to do it programmatically.I can get back a list of all the widgets but there’s no explicit information about which cell they belong to. I guess it may be possible to calculate which cell each widget belongs to by using the table’s bounds and the widget’s co-ordinates but I haven’t looked into that yet. To give an example I would like to be able to programmatically determine that the “Whiskers” sticky belongs to the “Cats” column and “Names” row. 

4283
Ronny Roeller
10 months ago
T
Trevor FoxNew Here
posted in Developer platform and APIs
Can't upload file using SDK

I used the app SDK quickstart to make an app. Up until an hour ago, it was working. Then the file input stopped working. I haven’t touched this part of the code (to my knowledge) and the file select input event handler is not triggering at all. I have the following code:app.jsdocument.getElementById('csvFileInput').addEventListener('change', handleFileSelect, false);function handleFileSelect(event) { console.log('file'); const file = event.target.files[0]; if (file) { const reader = new FileReader(); reader.onload = function(e) { const contents = e.target.result; const rowsArr = processCSV(contents); buildGraph(rowsArr); }; }}...app.html&lt;!DOCTYPE html&gt;&lt;html lang="en"&gt; &lt;head&gt; &lt;meta charset="utf-8" /&gt; &lt;meta name="viewport" content="width=device-width, initial-scale=1.0" /&gt; &lt;script src="https://miro.com/app/static/sdk/v2/miro.js"&gt;&lt;/script&gt; &lt;title&gt;My App&lt;/title&gt; &lt;/head&g

331
Horea Porutiu
Mironeer
10 months ago
Bentley Davis
Bentley DavisBeginner
posted in Developer platform and APIs
Error when using Airtable (and other npm packages) with create-miro-app React Typescript

Has anyone else tried using libraries with the create-miro-app React TypreScript option? I followed the Hello World Miro example and it works fine but when I add Airtable and even though none of the Airtable code runs I receive the error:Uncaught Error: Module "stream" has been externalized for browser compatibility and cannot be accessed in client code. at Object.get (browser-external:stream:3) at node_modules/node-fetch/lib/index.mjs (index.mjs:10) at __init (chunk-EB7XYW2R.js?v=d66c9224:9) at node_modules/airtable/lib/fetch.js (fetch.ts:2) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at node_modules/airtable/lib/base.js (base.ts:4) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at node_modules/airtable/lib/airtable.js (airtable.ts:1) at __require2 (chunk-EB7XYW2R.js?v=d66c9224:12) at dep:airtable:1I have spent several hours looking it up and trying different options but even though the error changes I have not been able to make it work. Here is a sa

6844
A
10 months ago
Terms & Conditions