Developer platform and APIs

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

  • 805 Topics
  • 2,597 Replies

805 Topics

William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

NEW: Experimental release of Session Management and Attention Management in Web SDK

Hey, everyone!We’re excited to share that Session Management and Attention Management capabilities are now available in experimental release in the collaboration namespace miro.board.collaboration in the Web SDK.These new methods and components allow you to handle collaborative features on Miro boards, including: session management, attention management, remote viewport control, and more. With this experimental release, you can:Create collaborative experiences across multiple users on the same board Handle collaborative features on Miro boards, including: Starting and ending collaborative sessions Attention management Control the viewport Subscribe to events related to when users join or leave a collaborative session➡ Ready to get started? Visit our documentation to start working with these new capabilities:https://developers.miro.com/changelog/2023-11-27-changelog

0
William Bishop
Mironeer
11 days ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Developer Webinar: Build an Asset Manager app with Miro's Web SDK

Hey, developers!Looking for ways to streamline your workflows in Miro? Register for our developer webinar on December 12th and learn how to build an Asset Manager using Miro's Web SDK.Learn how to:→ Generate a boilerplate app from the command line→ Programmatically interact with board items→ Style and run your app on a Miro boardSave your spot →

0
William Bishop
Mironeer
19 days ago
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs

Find us on Developer Q&A every other Wednesday at 5:30PM CEST

Hey, Miro developers! We’d like to invite you to join our bi-weekly Developer Q&A sessions, a dedicated time for you to get insights on any questions or topics you might have. It is hosted by our Developer Relations team and often we will also have special guests from the Developer Platform engineering and product team to cover more specific topics.  When: every other Wednesday at 5:30PM CEST/ 9:30AM CT, lasting for 30 min. Where: on our Discord channel #developer-Q&A-sessionsWho can join: everyone exploring or building with the Miro Developer Platform is welcome to join - no matter how much experience you have with the Platform, this time is for you.  How to submit topics for discussion:Interested in exploring a specific topic, or have questions on something in particular? Feel free to let us know by adding a comment in this thread or sharing your ideas with us on Discord! For more common questions and topics, feel free to bring up during the session - no advance needed.  We o

0
William Bishop
Mironeer
10 months ago
S
shawngNew Here
posted in Developer platform and APIs

general area for keyboard shortcuts

the keyboard shortcuts should all be on either the right or left side of the keyboard as opposed to being name related (P for pen, T for text, etc.). this makes it very hard to operate one-handed. if my right hand is on the mouse, my left hand is on the left side of my keyboard. i don’t want to make my right hand leave the mouse nor drag my left hand to the right side of the keyboard.at the least, this shoudl be an option to choose from.

1
Mettin
Mironeer
6 minutes ago
S
Stacey FortunaNew Here
posted in Developer platform and APIs

Embedding frame only to an external link

Use case: I copied a miro frame’s link and pasted/embedded it to an external tool like ClickUp Docs.Issue: Copying the frame link shows the entire board, which at times does not show the frame initially but some other part of the board. This could be a problem to non-miro users who will view the file from ClickUp. Embedding specific frame links to external tools like ClickUp can be really helpful for dynamic teams. who may change the contents frequently.

1
Mettin
Mironeer
23 minutes ago
M
MewifoxiiiNew Here
posted in Developer platform and APIs

The tools are not shown

I have a Starter plan, and I can't invite a student to the board, I copy the link that has the "edit" permission, he follows the link, but the tools are not shown. What to do?

1
Robert Johnson
1 day ago
K
KristenFlyNew Here
posted in Developer platform and APIs

board doesn't work

Good afternoon!One of boards in a team doesn't work.. it contains a lot of important information.. other boards work great, but not this. It writes about bad connection, and tells to reconnect. But the internet is good. I tried to open it from different devices, but it still doesn't work.Please, can you help me?Regards,Kristen

0
K
1 day ago
K
KristenFlykNew Here
posted in Developer platform and APIs

Only one board in a team doesn't open and writes that it should be reconnected

Hello! Excuse me, one of my boards in a team can't be opened. Every time there is a message that I need to reconnect, but other boards work great.. I have a lot of important information there.. please, tell me, what should I do?

0
K
1 day ago
J
Joel HNew Here
posted in Developer platform and APIs

Tired of manually managing Miro Licenses?

Hey everyone, can I get your input on this tool we're launching on the Miro app store?Here's how it works right now: If a user doesn't log in or shows no activity on Miro for 90 days, they'll get notified to confirm they still want access, if they opt out and say they don't want access, we'll remove their license.Helpful? Meh? Let me know! 

0
J
2 days ago
N
Nataly2527New Here
posted in Developer platform and APIs

Пропал доступ к моей доске

Я создала доску на бесплатном тарифе, все было нормально, но сегодня я не смогла ее найти у себя в аккаунте, по ссылке, которую я давала для доступа, сказано, что он закрыт, как такое может быть, если эту доску создавала я?? Помогите вернуть доску обратно

1
Robert Johnson
4 days ago
F
French to go AdministrationNew Here
posted in Developer platform and APIs

Tool bar removal during presentation?

  I would like to know if it's possible on the prensentation mode to remove the tool bar (please see screenshot) that is presenting the different modification we can do).

1
Robert Johnson
8 days ago
U
uxmccauleyBeginner
asked in Developer platform and APIs

baackgroundColor property for miro.board.widgets.create method

I have the following code to recursively create a custom sticky widget from a CSV inside a web plugin. miro.board.widgets.create({ "type": "sticker", "style": { "backgroundColor": "#ea94bb", "fontFamily": "Bangers", "textAlign": "right" }, "text": data[i][filter], "x": ( 220 * horizontal ), "y": ( 220 * vertical ) })Regardless of what color I substitute in the backgroundColor property, I cannot get the stickies to generate as that color. They always get created yellow. I have run this same method with the “shape” widget and I get the correct specified background color. It there some nuanced approach to coloring stickers that I am just overlooking? I have been through the API documentation at least two dozen times. 

5
B
9 days ago
D
DybolNew Here
posted in Developer platform and APIs

Customization of embedded board

Hello,I would have some questions regarding possibilities of customizing miro board. My goal is to embed miro board into my website and use it to my own private lessons. Therefore, I’d have couple of questions:Is it possible to export the board to PDF if the board is embedded? I don’t see such option, for me it is only visible on regular miro board, not embedded one. Is it possible to customize the UI (I’m mostly interested really simple UI, like at webwhiteboard.com - since I’d only use miro to write things) Is it possible to add ‘Video chat’ icon to the main top panel - so that it is visible right away (or ideally, start video chat right after joining the board) I tried to look into the documentation, but I didn’t find the answers. I would appreciate your help.Best regardsMikołaj

3
Raktima Saxena
Mironeer
10 days ago
M
Miguel ContenteNew Here
posted in Developer platform and APIs

PlantUML Modal wrong dimensions

The Modal for plantUML started getting the wrong sizing around 2 days ago. In a full screen both the editor and preview are only occupying 15% of the available screen height.

1
Raktima Saxena
Mironeer
11 days ago
T
Tim MoserNew Here
posted in Developer platform and APIs

BUG: Rest API creates board in view only

Below is a bug report for some unexpected behaviour I have found when working with the api as a free plan user. Steps to reproduceCreate a board using an access token of a free account through the REST API, noting the resulting board ID (post v2/boards) Create a frame in the board (post v2/boards/ID/frames)Actual Result403 - User is not authorized to create widgets on this board.Upon further investigation in the miro dashboard, I notice that the board is created in view-only, therefore not allowing me (and my access token) to edit it.Expected ResultSince the created board is the most recent board, it should be editable even for free accounts exceeding 3 boards (by making an older one view-only). This would then allow me to also edit it through the api, without the error.

4
T
11 days ago
D
delezeNew Here
posted in Developer platform and APIs

REST API how to export frame to image

Hi all,How to export a frame as image using the REST API ?Thank you for your support!

9
H
13 days ago
C
Chandra SekharBeginner
posted in Developer platform and APIs

Create a table in a frame using REST API

Hello Team,May i know how to create a table in Miro frame dynamically using REST api and create row / coluns with cards in it . also how to read the rows and column contents from a given table/frame 

1
C
Mironeer
16 days 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?

13
William Bishop
Mironeer
19 days ago
J
Jason1979Beginner
posted in Developer platform and APIs

API update shape text with line breaks

I’m trying to update a shape with a line breakshape_content = "This is a shape with\na line break."data = { "data": { "content": shape_content } }but Miro doesn’t give me a line break. I can manually do it just by hitting enter.  Can anybody help me with this? 

1
William Bishop
Mironeer
20 days ago
C
Chandra SekharBeginner
posted in Developer platform and APIs

Miro REST API not able to fetch Card color

Hi Team,We are trying to differentiate cards on the frame by the color ( Epic : Red , Story: Blue, ...)  and using REST Api we are not able to see the color information. May i know if i’m missing something or is there any workaround.As there is no API to get jira_card , we thought of using color to differentiate the card types by color. This is very important for us to segregated cards via API for further analysisBelow is the example of card fetched via rest api{    "id": "3458764570230418111",    "type": "card",    "data": {        "description": "<p>Acceptance Criteria : Users can set preferences; system suggests matches based on preferences; accept/reject matches.</p><p><br /></p><p>Benefit Hypothesis : Blah Blah Blah</p><p><br /></p>”,        "title": "Title Blah"    },    "style": {        "cardTheme": "#f24726"    },    "geometry": {        "width": 671.9075024462501,        "height": 281.3612666493672    },    "parent":

0
C
23 days ago
S
Sergey VorozhtsovBeginner
posted in Developer platform and APIs

Batch endpoints

Hi all.My case is - we render complex diagram with 1600 objects one the same board and other employees have read access. The board should be updated in some interval - every hour, for example.My first issue - posting. I post all those 1k+ object one by one which is slow and not efficient from CPU POV for both sides - miro and my app side.  Maybe miro developers can provide batch endpoint to accept list of objects?Next issue - recreating diagram, I can’t push only changes to the board, because logic would be super complex, because I’ll have to recalculate size of all elements, so it’s much easier for me to delete all and post everything again. My question is - How do I clean up the board with API? There is no such api right? I have to fetch all items by GET https://api.miro.com/v2/boards/{board_id}/itemsand then delete them ONE BY ONE withDELETE https://api.miro.com/v2/boards/{board_id}/items/{item_id}Is that correct? That’s ridiculous isn’t it?There should be batch endpoint for these o

11
Josip Janzic
Mironeer
23 days ago
S
SixfootJamesNew Here
posted in Developer platform and APIs

Populate Mindmap From Excel Sheet using n8n.io

Hello,Has anyone populated a mindmap from an Excel spreadsheet from the automation tool, n8n.io? Many thanks

1
sammusaev
24 days ago
T
Tammo DirksenBeginner
posted in Developer platform and APIs

REST API Can´t retrieve tags properly

I am using the REST API to retrieve all app cards with a certain tag. I first retrieve the tags using the method Get tags from board which retrieves my tags with their IDs. I get all the tags properly. Now when using the endpoint Get items by tag I enter the board id and the tag id. For certain tags I created I get all the items. But for some tags I just get the following response:{ "type": "error", "code": "3.0201", "context": { "boardId": { "value": "MY BOARD ID" //Of course this is not an actual board id } }, "message": "Item not found", "status": 404}Has someone experienced similar issues? Yesterday the request worked for some tags it doesn´t work for today. How on earth does it work on some tags on that exact same board and on some it doesn´t?

8
Josip Janzic
Mironeer
24 days ago
N
Norbert SzolnokiNew Here
posted in Developer platform and APIs

Get user role on board with SDK or API

I am developing an app that will be an integration for our CMS system (Gridly), and I would like to restrict a part of the app by the user role in the opened board.I searched, but I can’t find any call that could give me the current user role in the Board.

2
Josip Janzic
Mironeer
25 days ago
F
flyingsaucerinvasionBeginner
posted in Developer platform and APIs

Can I export line position data? Desperate need!

In order to save us hundreds of hours of manual work, we must find a way to export line points position data from our miro board!We also need to be able to export picture position and size data, so we can know where the lines are relative to the background they’re placed over.

1
William Bishop
Mironeer
28 days ago
Terms & Conditions