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>

  • 984 Topics
  • 3,107 Replies
984 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&amp;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&amp;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 nee

3024
William Bishop
Mironeer
5 months ago
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 MiroThe 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 MiroThis 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 produc

1010
William Bishop
Mironeer
5 months ago
Ronny Roeller
Ronny RoellerBeginner
posted in Developer platform and APIs
App submission is stuck

Our app (ID 3074457347393893408) is in the state “Submitted” since months. I don’t recall as ever getting a message about it.We’re can’t resubmit it with updated content again (this gives 422 error in DevTools).

343
T
4 hours ago
C
captinSharkyYNew Here
asked in Developer platform and APIs
for someone need to see the demo enterprise plan ??

I want to test for the enterprise plan I dont want to spend my time and money blindly 

81
ElvaMiro
Mironeer
15 hours ago
S
Sayaka HoriguchiNew Here
asked in Developer platform and APIs
App submission is stuck

I submitted three applications (MAPR-1186, 1187, 1188) to the Marketplace on November 18th, but their status remains as "submitted".I have sent follow-up emails to the JIRA ticket but haven't received any response. Could you please help us check the current review status of our applications?

133
A
Mironeer
1 day ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Handling 307 Redirects and Token Issues in Miro API Requests

Hey community,I’m facing a tricky issue with my application when fetching boards, items, images, and document binaries using the Miro API.Here’s the flow:Token Generation: Each time the application starts, it obtains a token to authenticate API requests. Handling Redirects: When fetching images and binary documents, I receive a 307 Redirect. I handle this by extracting the Location header and redirecting accordingly.This works fine up to this point.However, the issue arises after the redirect:The redirected host requires a new token, causing my application to break since subsequent requests still use the old token.My experience with APIs suggests it’s possible to maintain multiple valid tokens simultaneously for different requests.My Question:Why does the Miro API invalidate - delete the old token when a new one is generated?Is it possible to have multiple tokens active at the same time for different requests in Miro?Any insights or suggestions would be greatly appreciated!Let me know

536
V
1 day ago
D
DavNew Here
asked in Developer platform and APIs
Whitelist ?

Hi, A Student in our school will be using Miro, as part of his Uni application, is there a URL whitelist available so no problems arise on the day ?

111
Eca
Mironeer
3 days ago
godofprogrammer
godofprogrammerBeginner
posted in Developer platform and APIs
Curious about Plugins

Can you guys please suggest me some best Miro templates or plugins for managing large-scale project workflows. I am asking for one of my client, where I have to handle his website and they guys are offering translation services for families. You know you involves multi-lingual barriers along with the legal actions, so need something should be highly accurate.Thanks in advance if you find this one interesting.

143
godofprogrammer
4 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Custom Item Creation in Miro Partner Apps: Is It Possible?

Hey community,I hope you're all doing well!I've been asking a lot of questions lately, and here's another one:Is it possible for Miro partners to create custom item types within their apps?For example, can an app from the Miro Marketplace introduce a unique item type with specific features?I know this might be a bit ambitious, but I’d love to hear if this capability exists or if there are plans to implement something like this in the future.Plus, is there any endpoint that is lists all the possible item types?Thanks in advance for your insights!Best regards,Vas

121
William Bishop
Mironeer
6 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Issue with Pagination Behavior on Miro Groups Endpoint

Hey community,I'm experiencing an issue with the Miro API when using the groups endpoint:https://api.miro.com/v2/boards/{board_id}/groups?limit=50The pagination doesn't seem to work as expected. Instead of navigating to the next page of groups, it redirects me to pagination for items.Is this the expected behavior, or could it be a bug? Any insights would be appreciated!Thanks in advance!Payload: 

253
Horea Porutiu
Mironeer
7 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Questions About Image Handling and Query Parameters in Miro API

Hey community,I have a couple of questions regarding image handling in the Miro API: Differentiating Uploaded vs. Predefined Images Is there a way to distinguish between images I’ve uploaded and those predefined on a board template? Fetching Image Files To fetch the actual JPG of an image, I currently have to follow this three-step process: Step 1: Make a request to fetch items and grab the imageUrl. Step 2: Request the imageUrl to obtain another URL. Step 3: Make a final request to the new URL to fetch the JPG. The URLs include query parameters like Signature and Key-Pair-Id. What is the purpose of these parameters, and is it possible to use them to group predefined images on boards? Any help would be greatly appreciated! Thanks!

202
V
7 days ago
J
Jairo da Costa Barbosa FilhoNew Here
posted in Developer platform and APIs
Cant change to Free Restricted SCIM API

Im trying to do a script powershell with a function who changes ‘userType’ from ‘Full’ to  ‘Free Restricted’, but it dont work (error 400 ). I tried with PUT and PATCH methods.  If i try to change from ‘Full’ to ‘Free Restricted’ it works properly. Can i have a support? Thanks!

3829
Horea Porutiu
Mironeer
11 days ago
C
CuchulainBeginner
asked in Developer platform and APIs
Permission problem with Python Flask Sample app

Hi all,I followed the instructions to get the Python flask app up and running, but I get an error with the final create_board method. The app has the boards:write boards:read scope. Would anyone have any ideas? Many thanks. /CThe API response for your code exchange request: {  "user_id" : "n",  "scope" : "boards:write boards:read",  "expires_in" : 3599,  "refresh_token" : "t1",  "token_type" : "bearer",  "access_token" : "a",  "team_id" : "t2"}INFO: GET /callback?code=eyJtaXJvLm9yaWdpbiI6ImV1MDEifQ_EypQq0&amp;state=&amp;client_id=1&amp;team_id=t2 HTTP/1.1" 200 -INFO: "GET /favicon.ico HTTP/1.1" 404 -INFO:root:Creating board with access token: valid_token&lt;Response [403]&gt;INFO:root:Create board response status code: 403ERROR:root:Failed to create board. Status code: 403, Response: {  "type" : "error",  "code" : "4.0602",  "message" : "Insufficient permissions to perform operation. Please check the permissions or contact support",  "status" : 403}

362
C
11 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Seeking Advice on Increasing Miro API Rate Limit for Enterprise Account

Hello Community,I'm currently encountering an issue with rate limiting in Miro’s API, as outlined in their documentation(https://developers.miro.com/reference/rate-limiting).I have an Enterprise account, which provides a limit of 100,000 credits per minute.I’m wondering if there is any way to increase this limit.Specifically:Is this rate limit fixed for the Enterprise plan? Are there options to increase the limit without switching plans? Would upgrading to a different plan help?Any insights or advice would be greatly appreciated.Thanks in advance!Best regards,Vas

131
Horea Porutiu
Mironeer
11 days ago
S
Sven12345New Here
asked in Developer platform and APIs
SAML SSO using NetScaler

Hello,unfortunately the support seems to be from the US only. Since I am from Germany it is not really possible to solve problems in a quick manner, so I hope the community can help me.Is anyone using SAML SSO successfully with Citrix NetScaler? I can’t make it work. NetScaler is reporting that it can’t find the target URL and I am not really sure why.We are using several other products with SAML SSO without any issues. When using the SAML Tracer to identify the problem I can see that other SPs are sending a metadata file in a second POST step after the inital call of the login page. Miro is not doing that I am sure this is the reason I can’t make it work with NetScaler.Or maybe I am just missing something, so any help is greatly appreciated.Thanks!

250
S
12 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Inquiry About Board Visibility Delay in Miro API

Hello Community,I have a question regarding the Miro API that I hope someone can help clarify.I've noticed that there seems to be a significant delay between the time I create a board in the Miro web UI and when it becomes accessible via the endpoint `https://api.miro.com/v2/boards/`. Can anyone provide insight into the exact time it typically takes for this API, specifically this endpoint, to reflect newly created boards?Additionally, I've encountered a peculiar situation where some freshly created boards are not visible through the `https://api.miro.com/v2/boards/` endpoint, yet they can be accessed using `https://api.miro.com/v2/boards/{board_id}` endpoint (with the board ID retrieved from the Miro web UI URL). Can someone explain this inconsistency in visibility?Thank you in advance for your assistance!Best regards,  Vas

172
Horea Porutiu
Mironeer
13 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Understanding Miro User License Options and API Usage

Hello community, I'm currently working with the Miro API endpoint:https://api.miro.com/v2/orgs/{org_id}/members In this endpoint, I noticed that there is a `license` query parameter.After conducting some tests within my enterprise organization, I found that I could only create users with the full and free license attributes.I would like to understand how I can set some users to have the following license attributes:- occasional, free_restricted, full trial and unknown. Could someone please explain the different license options available in Miro and how to implement them through the API?Thanks in advance,BR Vas 

401
Horea Porutiu
Mironeer
15 days ago
L
LethNew Here
asked in Developer platform and APIs
My Miro dashboard is not loading.

When I am going into the miro dashboard it won’t load. And when I press a miro invite link to a miro board, the board doesn’t work, I can only look around.

100
L
15 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Inquiry About Error Messages for Miro REST API

Hello community,I noticed that there are details about error messages related to the SCIM API available at this link: https://developers.miro.com/docs/errorsHowever, I am looking for similar information regarding the Miro REST API.I haven't been able to find any documentation on possible errors for the REST API.I have encountered some errors during my work, and they do not correspond with those listed for the SCIM API.Am I overlooking something?Thank you for your assistance!BRVas 

171
William Bishop
Mironeer
18 days ago
V
vkokoActive Contributor
posted in Developer platform and APIs
Clarification on Pagination for Boards and Items

Hello Community,I’ve been exploring pagination for boards and items in the API.I noticed that while boards support offset-based pagination, items don’t seem to provide any offset-related information.Will offset-based pagination be implemented for items as well?Is there a specific reason for this inconsistency, or am I possibly missing something in the documentation?Looking forward to your insights.Best regards,Vasileios

111
William Bishop
Mironeer
19 days ago
G
Guru IntegrationsNew Here
asked in Developer platform and APIs
API "self" Link returns 400 Error

Hi There,I am using the /boards/{boardId}/items endpoint to return all items on a specific board. In the response, I’m getting a number of items returned, and each of those items has a API URL value in the data.links.self field. However, for some of those values, calling the GET endpoint returns a 400 error (code: operationNotSupported).Example response from /boards/{boardId}/items:{ "size": 10, "limit": 10, "total": 11, "data": [ { "id": "3458764607565328883", "type": "shape", "geometry": { "width": 262.06732667592587, "height": 131.03366630422926 }, "position": { "x": -246.9185046725638, "y": 395.1632647477584, "origin": "center", "relativeTo": "canvas_center" }, "links": { "self": "https://api.miro.com/v2/boards/uXjVLCuZXck%3D/items/3458764607565328883" }, "createdAt": "2024-11-19T18:44:56Z", "createdBy": { "id": "3458764584978600694", "type": "user" }, "

491
William Bishop
Mironeer
19 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Clarification on Using Tags in Items

 Hi, community!I’d like to clarify which items support tags.From what I’ve observed in the web UI, tags can be applied to sticky notes and cards.Am I correct, or are there other items where tags can be used that I might have missed?Looking forward to your input! BR  Vas

241
William Bishop
Mironeer
20 days ago
S
saifisBeginner
asked in Developer platform and APIs
Can you lock objects made via API when they are created?

I want to lock some objects when having a set of objects created since they act as background objects, I know you can do this on board, but can it be done when created via miro.board.widgets.create?

7988
H
21 days ago
V
vkokoActive Contributor
asked in Developer platform and APIs
Request for Clarification on Item Types in API

Hello Community,I am using the endpoint(https://developers.miro.com/reference/get-items)that lists all items, and by utilizing the `type` query parameter,I can filter the results to specific item types.This feature is fantastic!However, I have noticed that there are additional item types, such as "table" and "unknown," which are not documented.I have a few questions:1. Where can I find a complete list of all available item types?2. Are there plans to include these additional types in the query parameters for filtering?3. Will items with the type "unknown" be renamed to more meaningful names in the future?Thank you in advance for your help!BR  Vas

231
William Bishop
Mironeer
21 days ago
L
LB LNew Here
asked in Developer platform and APIs
Is an App only active, when it is open in the side panel?

Hello everyone,I am new to the Miro development and have a basic question that I need to be solved once and for all: Do I understand correctly that my Miro app can only do things on the board when it is actively open in the side panel?For example: If I want to build an app that changes the viewport when an event happens on the board, I can get that event information using webhooks. But if I want to react to this event, I have to send a command to a Web SDK, e.g. via WebSockets. But this WebSDK app is only active when it is open in the side panel. Please help me understand this fundamental basic of developing for miro. Thanks a lot!

322
L
25 days ago
Terms & Conditions