Skip to main content

Developer platform and APIs

Discuss everything related to Miro API, SDK, embedding and Miro Platform apps development.

  • 1,034 Topics
  • 3,259 Replies
1032 Topics
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
Find us on Developer Q&A the first Wednesday of each month

Hey, Miro developers! We’d like to invite you to join our monthly 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: The first Wednesday of each month at 5:30PM CEST/ 9:30AM CT, lasting for 30 min. Where: on our Discord channel #developer-Q&A-sessions Who 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. W

3764
William Bishop
Mironeer
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
ServiceRocket builds 3 new apps on top of the Miro Developer Platform

ServiceRocket builds 3 new apps on top of the Miro Developer Platform Hey, developers! Want to learn more about the art of the possible on our developer platform? ServiceRocket has just launched 3 new enterprise-ready integrations for Salesforce, GitHub, and Autodesk—each built on top of Miro’s Web SDK and REST APIs. Check them out here: Salesforce for Miro The Salesforce for Miro app enables users to interact with Salesforce data from directly within their Miro board. With this new app, you can now use Miro to manage sales activities, account planning, opportunity management, and more, with a direct connection between Salesforce and Miro. 📽️ Watch the demo GitHub for Miro This realtime, bi-directional sync between GitHub and Miro enhances collaboration across platforms, reduces costs for product and engineering organizations, and increases efficiency. With the GitHub Connector, you can bulk convert GitHub issues to cards in Miro, search and add issues, and more, facilitating better p

1430
William Bishop
Mironeer
D
DritonNew Here
asked in Developer platform and APIs
First time creating a Miro app problem

Hello! So yesterday I got an idea that I wanted to create a app in Miro and i started searching how I can do so and found a great guide on how to get me started but I gave up quite fast because things where not working on my work computer due to some restrictions. So I ended up deleting the “Developer team” (I think It’s called), but now when I want to do the same thing again i get the error or warning saying “User has already created developer organization“ but I can’t find any developer organization or team…? I have created a case on this but maybe someone here has an idea on how I can solve this? Thanks,Driton

152
Robert Johnson
E
Egor KraevBeginner
asked in Developer platform and APIs
Webhooks not triggering on mind map node creation?

Hi, I’m running the example app at https://github.com/horeaporutiu/miro-webhooks-python , having set it up as per the instructions at https://developers.miro.com/docs/getting-started-with-webhooks-pythonStrangely, it looks like the app only gets called when nodes in the mind map are modified or deleted, but not when they are created. Is this a bug or am I missing something?Thanks,E.

171
William Bishop
Mironeer
S
Stephane BARIZIENNew Here
asked in Developer platform and APIs
Bi-directional link between Miro Mind Map and Jira

I’m investigating the possibility to create (e.g., via PowerShell code leveraging the Miro REST API) a bidirectional link between a Miro Mind Map and Jira tickets. This would need adding a custom “Jira ticket ID” property to each of the nodes in the Miro Mind Map. I’m trying to use the PATCH method on a mindmap_node, but this doesn’t seem to be supported (“Operation not supported”, status 400). Have a hit a dead end (Custom attributes for Mindmap node | Miro is 2 years old, maybe this is now possible)?

932
E
William Bishop
Mironeer
William BishopMironeer
posted in Developer platform and APIs
New in the REST API: Experimental support for Mind Maps (Create, Read, Delete)

Hey, everyone! We’re excited to announce experimental support for creating, reading, and deleting Mind Maps via the REST API. Important! Mind Maps are not yet supported in production endpoints. You can use the experimental endpoint to explore these APIs. Ready to get started? Check out our API Reference here. Changelog entry: https://developers.miro.com/changelog/2023-11-3-changelog P.S., have feedback for us? Please share any and all of your feedback with us here in the thread below, or in the #experimental channel on our Discord server. 😎

2874
E
E
Egor KraevBeginner
posted in Developer platform and APIs
Is it not possible to generate a permanent API token for use in scripts?

I want to read and manipulate mind maps using the miro_api package, and the only way to authenticate appears to be through OAuth, and using that for development a local machine is a royal pain. Why am I forced to do the OAuth song and dance to authenticate? Most other platforms, such as Linear and Confluence, allow me to create an API token with a single click, and then I can just access them with a Python script, without spinning up web servers and other OAuth nonsense. Surely it should be up to me how much security I require at a given point? Or is there a way to generate a static API token, and I just couldn’t find it?

152
E
M
Mathieu RothNew Here
asked in Developer platform and APIs
Performance issues on large pages. Tried the recommendations.

Hi there! Long time user here. Description of my issue: performance is bad on my large board (currently around 1300 objects). It’s worse on Firefox than Chrome (firefox: the zoom and dezoom is really bad). Both equally are bad when it comes to adding a new object or editing text, with a serious 0.5 to 1sec freeze. I did read the thread about performance, and the possible solutions. Cleared cache, and reviewed the image sizes. For info, I do use a lot of tiny images, and made sure to flatten in small size most of them. My question is: I tried using synced groups in an attempt to lower even more the memory usage (my train of thought is: if I use one image and it’s instanced several times and synced, in theory the memory usage, or at least the bandwidth shall be only for the one image). Turn out the gains are minimal or nonexistent. At this point, I have no real solutions. Except maybe slicing parts of that board into another board, flattenning one JPG file out of it, and importing it aga

131
Eca
Mironeer
M
Marleen KinderBeginner
posted in Developer platform and APIs
Deleted users are using their company email for their personal Miro account.

Miro seems to maintain all our old employees and associates accounts on their system even though we delete them from our company account. This is an issue for security and clarity in offboarding people. If they used their email and a password to access their account, rather than single sign in/OAuth using Google, they would still have access and not be locked out. I understand that this is not the case on the enterprise plan but in my opinion should be a feature on the basic plan too.

81
Eca
Mironeer
K
karol931Beginner
asked in Developer platform and APIs
API App card width.

I am trying to recreate existing board to another one through the API and I have encountered a problem.It is not possible to create app card that has less than 256 width through the API.Documentation doesn’t say anything about limits and it is possible to do that on the board.

202
K
G
Guglielmo RaiolaNew Here
asked in Developer platform and APIs
Change display name

Hello team, Is it possible to change a display name where it is synced through entra? Currently have a user who wants to change their display name to their middle name.

72
Eca
Mironeer
S
Stylianos PantelakisNew Here
asked in Developer platform and APIs
Invoice

Dear all, How can I see who in our company is responsible for our Miro account? It is very important because the invoices are payed from my Kredit Card. Best Regards Stylianos Pantelakis

61
Eca
Mironeer
kubens_dev123
kubens_dev123Beginner
posted in Developer platform and APIs
API: Big bug with updating parent of an item.

Hello, I’ve found out that updating parent of an item (via PATCH boardID.type.itemID endpoint) does not work properly in a specific scenario: You want to move an item to a frame that was created after the item was. Such operation results in adding the item to frame’s children list, but the item is hidden and invisible under or below the frame. While moving the frame, the item moves along. It is also very inconvenient to bring this item back to the foreground. Updating parent works correctly only when trying to move an item to pre-existing frame.

402
kubens_dev123
P
Pavel SyrnikovNew Here
asked in Developer platform and APIs
Unassigning a Card via the Miro API

Hello Miro Support Team, I am currently working with the Miro API and using the "Update card item" endpoint (PATCH https://api.miro.com/v2/boards/{board_id}/cards/{item_id}) to manage card details. My goal is to remove the current assignee from a card. However, I have tried setting the assigneeId to null, an empty string, and even omitting the field entirely, but none of these approaches seem to unassign the card. Could you please advise if there is a supported method for unassigning a card via the API? If not, is there a planned update to allow this functionality? Any guidance or workaround you can provide would be greatly appreciated. Thank you for your help. Best regards, Syrnikov Pavel

242
P
O
OlehContributor
asked in Developer platform and APIs
App icon disappears from app list after page reload

Hi guys!I have strange behavior with my app so maybe someone can help me.I installed the app in user settings and see app icon in app list on my board. I open the app and got authenticated. After that I can work with the app BUT after page reloading the app icon disappears from the app list on my board. What it can be ? Is there something wrong with my app or it’s OK because it’s not published in market? Now it’s deployed on Vercel.

588
O
A
Anna VasNew Here
asked in Developer platform and APIs
URGENTLY!!!!! my personal board disappeared how did i leave the group

In the upper left corner there are groups, and it turns out I was a member there. I created my boards, and I always got an error that I had overcome the barrier in editing 3 boards. I did not understand why this was happening. I saw that I was in some group and clicked to delete from there .... and I saw how my boards disappeared ... shock, tears. I do not even remember who else was in this group and who was its administrator. I send requests to edit my board (I found its link), but I only receive a notification that my access was sent to the owner ... Which owner? if I was the owner? how can I now find out who my access depends on? and who can give me access to this group again? how can I find the history of my board? can someone from tech support help me restore my access, since I do not even know who to contact ... and these are very important boards for me !!!!!!!!!!!!!!

484
Robert Johnson
L
Laurent AmoravainNew Here
asked in Developer platform and APIs
Pagination configuration miro > n8n

Hey, I'm trying to configure Pagination for a Miro node in n8n but I definitely cannot make it work. I only receive the first 10 results. I read all the other topic on the community but I can’t figure it ouf I receive this information in the response : I try to configure it this way but I still only receive first 10 results : Am i doing something wrong ? Thanks a lot for your help,Laurent

130
L
S
SnezhanaNew Here
asked in Developer platform and APIs
the technical error

I have the free subscription, but I use only 1 board and still I’m not able t o use it. the program is telling me that I’m out of limit, which is not true. Please, fix it!

121
Robert Johnson
K
karol931Beginner
asked in Developer platform and APIs
Shape font size

It is not possible to set shape’s font size higher than 288 from API, while on the board it is possible to set fontSize higher.

182
K
C
Clinton LoweNew Here
asked in Developer platform and APIs
CICD Pipline Integration for Markdown Diagrams

As a system architect, I want to maintain diagrams using a markdown language (e.g. Mermaid), edit/store the markdown file with my source code (e.g. infrastructure as code repository), and then automatically upload that markdown file into Miro as part of my CICD pipeline triggered from repository changes so that my version-controlled diagrams then become available for viewing in Miro and linkable to JIRA tickets and Confluence documents. What features/support does Miro currently have in this regard?

101
William Bishop
Mironeer
C
Chris AmellNew Here
asked in Developer platform and APIs
500 Error on Update Text Item

Receiving this error when trying to update content of text box on Miro board. Any idea why, and how to fix it? { "type": "error", "code": "3.0000", "context": { "boardId": "uXjVLDHY-Os=", "itemId": "3458764622879464953" }, "message": "Internal error occurred", "status": 500}

223
Robert Johnson
G
George BockNew Here
asked in Developer platform and APIs
Create Space via API?

Can a Team Space be created through the API? I want to automatically create Spaces for projects from another tool.

130
G
M
marcfonBeginner
asked in Developer platform and APIs
How to get the metadata for a preview type item?

How do I get the metadata from an `preview` type item? The preview items contain urls to external pages that I need to extract. [ { "output": [ { "id": "3458764612000528999", "type": "preview", "geometry": { "width": 250, "height": 223.5234375 }, "position": { "x": -340.9169006347656, "y": -154.68751525878906, "origin": "center", "relativeTo": "canvas_center" }, "links": { "self": "https://api.miro.com/v2/boards/uXjVLyMfaRI%3D/items/3458764612000528999" }, "createdAt": "2025-01-01T19:01:43Z", "createdBy": { "id": "3074457346783176524", "type": "user" }, "isSupported": false, "modifiedAt": "2025-01-01T19:01:43Z", "modifiedBy": { "id": "3074457346783176524", "type": "user" } } ] }] I also found that when you slect type `preview` from the dropdown in the official api doc you get a 400 error. { "type": "error", "code": "2.0703", "context": { "fields": [ { "field": "type", "message": "Unexpected enum value preview, expected one of: text, shape, sticky_note, image, document, card, app_card,

8413
Horea Porutiu
Mironeer
V
Venkat ReddyNew Here
posted in Developer platform and APIs
REST API for new Miro AI Capabilities

is there any rest api available for AI Flowchart creation passing the user prompt/intent to the underlying model

653
Horea Porutiu
Mironeer
D
dewaverBeginner
asked in Developer platform and APIs
API Incostistency: Tags fillColor returning "unknown" instead of actual color

Hello, I’ve encountered an issue with the API Endpoint - Get tags from board where it returns “unknown” for the fillColor field instead of the actual color chosen form palette during tag creation. Update info: Seems like its an error with GUI - for example tag created using API with color “Cyan” has a different shade than any other available to choose from Is this a known issue with theAPI?Is there a timeline for fixing this inconsistency?

802
D
News & Announcements
Questions & Ideas
Ask the Community
Developer platform and APIs
Wish List
Inspiration
Terms & Conditions