Developer platform and APIs

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.

HelloI would like to install app to all team members. I know that for business and enterprise plans I can use team admin and org admin. How to achieve this with starter plan? If I will receive content for my app from each user then I will have many tokens to handle which is unacceptable.I need API access to private boards of members in each plan - how should I do this?

Hello everyone,When creating an app, I can clearly see options to select the following scopes:- `team:read`- `team:write`However, on a free plan, I’m unable to use certain endpoints, like `GET Teams` (`https://api.miro.com/v2/orgs/{org_id}/teams`), etc.So, I’m curious—what is the actual purpose of these scopes if they’re restricted on the free plan? BRVasilis

Hi, so I have this design document that I’m writing for my game, is it possible for me to somehow sync it to Miro board as I change it in Jetbrains Rider?

I created a board using the api (https://api.miro.com/v2/boards). I can see the boards in my list of dashboards (https://miro.com/app/dashboard/). However, when I try to access the dashboards using the API (https://api.miro.com/v2/boards), the recent-most board seems to be missing. Even in the api reference playground (https://developers.miro.com/reference/get-boards), when I try to make the get request, it only returns 2 boards, while have 3 (as visible in https://miro.com/app/dashboard/) This has been happening for quite some time now. Please help!

Hello everyone,I currently have two accounts,one on an Enterprise plan and the other on a Free plan, and I'm running some tests.To fetch details about my plan, I use the following endpoint:https://api.miro.com/v2/orgs/{org_id}/members,along with query parameters likefull, occasional, free, free_restricted, full_trial, and unknown to filter the results.However, I noticed that this endpoint is only available for Enterprise accounts.My question is:Is there a way to retrieve details about my plan through an API endpoint while using a Free plan?Thanks in advance!

Hello community,Is there a specific field or API endpoint that can determine whether the board is in 'edit mode' or 'view-only' mode?

I want to be able to export boards from Miro to pdf, for that - I see in the documentation I need to enable eDiscovery, but in my 'Enterprise integration' window I do not see an option to do so (I'm attaching a screenshot of how that window looks for me).Also, when I built the app in my development team I did not see an option to allow the scope board:export (a screenshot is also provided). 

Hi, We have a pretty huge board in Whimsical which we wanted to migrate to Miro. Was wondering if there is an easy way to do this via some tool?

Hello everyone,I’m an API developer currently building an app for my clients and have a few questions about Miro.1. App Installation Across Teams: When I share the installation link for my app with a client, they are required to select which team the app will be installed in.    Is there any way to modify this process so the app can be installed globally across all teams in the  client’s organization?2. Collaborating with Clients on Different Plans: My company is on the Enterprise plan, and I understand that collaboration is possible with clients who are also on the Enterprise plan.    Are there any limitations or blockers I should be aware of if I want to collaborate with clients using Free or Business plans?3. Administrative Tools: Apart from the Miro App Workflow, does Miro provide any additional administrative tools that can be used to manage apps or permissions more efficiently?Thanks in advance!

Hello everyone!I have a question regarding Miro's Enterprise plans.Our company has an Enterprise plan in Miro, and we're developing an app that we share with our clients. According to the Miro documentation, having an Enterprise plan allows us to use endpoints like this one to fetch a list of teams:Miro API: Enterprise Get Teams: https://developers.miro.com/reference/enterprise-get-teamsIf our clients, who do not have Enterprise plans, install our app on their accounts, will we still be able to fetch their teams, or do both parties (our company and the client) need to have Enterprise plans for this functionality? 

I’m using the bulk endpoint (https://developers.miro.com/reference/get-items) to get specific item type on a board. My first call I use the endpoint with the following params: “?type=sticky_note&limit=50” in order to get the first 50 sticky notes. This works as expected and I get the sticky notes with geometry, data, position, and style.However, when I run the same query but with “?type=shape&limit=50”, I can the same results minus the shape styles. This is annoying since I would have to the re-query (I think) for each shape to the specific shape endpoint (https://developers.miro.com/reference/get-shape-item) to get the styles.I would’ve expected the bulk endpoint to just give them to me.Is there a reason it’s doing this? Am I missing something? 

Hi everyone,I'm trying to find a comprehensive list of all the possible HTTP status codes that I might encounter while working with the Miro REST API. I’ve looked through the documentation but wasn’t able to locate anything specific.Any guidance would be greatly appreciated!Thanks in advance!

Hello Team,I have an old developer App that is used by multiple users. Now, I want to enable additional scopes in the app, but the scopes are not getting enabled.These are the steps I'm following: I click on scopes to add, then click install app. It says it's successfully installed and returns with an access token, but I refresh the page to confirm and it's actually not added.I would really appreciate any help fixing this as soon as possible.   

Hello Team,One of our clients is interested in integrating Miro’s drawing features into Polarion Live Docs. Currently, we have the Draw.IO feature available out-of-the-box in Polarion, but the client prefers Miro. Their requirements are as follows:Engineers will create drawings and templates in Miro. They want to export or move these drawings from Miro to Polarion Live Docs. Double-clicking the drawing image in Polarion Live Docs should redirect to the Miro application.As the Polarion Solution Architect, I am conducting a feasibility study and need access to Miro’s APIs. Based on my research, REST APIs seem suitable for this integration. I have a few questions:Can we access REST APIs on the trial version? Is it possible to access drawings from Miro through REST APIs for use in third-party applications? What are the costs for the premium version on a monthly and yearly basis?Thank you for your assistance. Your prompt response is highly appreciated.Regards,Md Tauseef Ahmed

Hello all,I'm in the process of creating a token for my app and using Postman for testing. You can see the relevant details in the attached screenshots.     When I click "Get New Access Token," my browser opens, and I can see that the authentication for my request is successful.    However, when I'm redirected back to Postman, I encounter the following error:    Am I missing a step or parameter, or doing something wrong? Has anyone else experienced this issue?I would really appreciate any help!Thank you in advance! 

. 

Hello,I am new with the Miro Rest API.I already have a little program that I can check for a board with a specific name is created and if not I make another rest call to create it.The problem is that when I use the https://developers.miro.com/reference/get-boards script, I noticed that the boards created by https://developers.miro.com/reference/copy-board do not show up or count.Anyone have this issue too?Does anyone were able to solve it?

I am a developer who is creating a SaaS Management Platform.We need to use Miro's Organization Members API.First, I created an app in Dev Team.And I tried to select the required scope, but the required organizations:read is not in the options.Please tell me how to do it.Do we also need to subscribe to Miro Enterprise in order to select the organizations:read scope?

Hello Miro Community,I'm developing an app that runs within an iFrame on the Miro platform, and I'm encountering a persistent issue with authentication. Here's a summary of the problem:The app is integrated into Miro and runs within an iFrame. It uses the Miro REST API for functionality. When attempting to authenticate via OAuth, I receive a "CSRF token is not valid" error. This error occurs specifically within the iFrame context. The authentication process works fine when accessed directly in a separate browser tab.I've already attempted to set the SESSION_COOKIE_SAMESITE configuration to 'None' to allow cross-origin requests, but the issue persists.The core of the problem seems to be related to how the CSRF token is handled within the iFrame environment, as opposed to a regular browser context.Has anyone encountered a similar issue or can provide guidance on how to properly handle authentication and CSRF validation for a Miro app running in an iFrame?Any insights or solutions would b

I’m trying to use sort=last_modified with the /boards endpoint but it doesn’t seem to be respecting it. Is this broken? Or is there some undocumented constraint about this parameter only being used in conjunction with other parameters? Tried combining it with e.g. team_id but to no avail.Specifically, when making this request:curl --request GET \     --url 'https://api.miro.com/v2/boards?sort=last_modified' \     --header 'accept: application/json' \     --header 'authorization: Bearer <token>' \    | jq '.data[] | .modifiedAt'I get back modifiedAt timestamps in this order:"2022-11-03T16:50:33Z""2021-04-06T18:58:11Z""2023-02-07T14:40:04Z""2024-06-03T17:52:46Z""2024-05-17T18:40:20Z""2024-08-20T22:48:45Z""2024-08-20T21:27:26Z""2024-04-15T22:50:32Z""2024-07-29T14:02:33Z""2024-03-20T23:07:33Z""2020-12-15T01:14:29Z""2024-07-12T18:51:24Z""2024-03-04T00:49:20Z""2024-09-12T15:23:06Z""2024-09-12T17:26:04Z""2024-09-12T18:22:34Z""2024-09-12T21:09:14Z""2024-09-12T22:00:57Z""2024-09-12T05:16:

Hi,I want to know if event listeners are available on connector events (creation, deletion and modifications. i.e. a user modified a connector connecting elements A and B to connect elements A and C) on a miro board. I am looking at the documetnation and the only relevant thing I can find is this:experimental:items:updateWhich says: Currently, experimental:items:update fires only when items are moved on the board, when an item dimensions are resized, when an item is rotated on the board, and when updating the scale of an item. In the future, the event will also fire when updating other item data.I read this as saying that connectors are not currently supported.Is this correct or am I missing something in the documentation?Thanks in advance

Hello,I have been using the Miro REST API to create boards, add items, etc.I understand that there are rate limits for the requests per minute, but it also says that there are costs for API calls. Where can I find how many credits do I have left? I am using the free tier.  

I am trying to convert our Jamboards into Miro Boards however the only option for import is to upload back up (seen below). I have tried to upload it as a Pdf however, the notes are, of course, unselectable. Any advice would be appreciated at this time.   

I was working on creating a script to refresh my access token, but I have not documented the latest refresh token, so I am stuck.  Is there a way to recover the current refresh token? I cannot call any API endpoints right now because I don’t have a valid access token and no refresh token to submit for a new access token.  Please help.