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>

  • 1,012 Topics
  • 3,206 Replies
1010 Topics
Y
YushinNew Here
asked in Developer platform and APIs
500 Error on get-tags-from-item endpoint

Hi! it appears the https://developers.miro.com/reference/get-tags-from-item API endpoint is returning 500 errors.Is there anything wrong with this endpoint ? Here’s what I know so far:items of payload are all sticky-notesSending the API request directly from the reference site does not result in an error.'x-request-id': 'c54a8c26-8334-4901-869c-5de2a22dc7fc' The error response data is as follows: { "type": "error", "code": "3.0016", "context": [Object], "message": "Internal error occurred", "status": 500} Thanks!

453
koalageddon
S
sanjay_novoBeginner
asked in Developer platform and APIs
try enterprise api

“ Enterprise onlyThis API is available only for Enterprise plan users. You can only use this endpoint if you have the role of a Company Admin and eDiscovery is enabled in the Settings. You can request temporary access to Enterprise APIs using this form.” As per the above I am unable to open the form which has been liked , I am getting the below error  

252
Horea Porutiu
Mironeer
O
Ofer YaarNew Here
asked in Developer platform and APIs
Looking for a Developer to create custom Miro App

Hi,I would like to make an app based on miro that would be focused on general cabinet design and kitchen design.I need to limit the abilities of miro so it would be easy enogh for carpenters to work with the app.The app is to be marketed seperatly

241
Horea Porutiu
Mironeer
E
ehubinNew Here
asked in Developer platform and APIs
No position or geometry when retrieving card items with REST API

I am using REST API to retrieve the cards on a miro board withhttps://api.miro.com/v2/boards/BoardId/items?type=cardmy board contains a significant number of items (&gt;100) and i am using the cursor feature to fetch all of them.For an unknown reason some cards are returned with a geometry and position object and some other cards are lacking this information. I have been unable to determine what drives this change in the API behaviour as all cards seems similar when looking at the board web page. When i try to retrieve these items individually withhttps://api.miro.com/v2/boards/BoardId/cards/cardId I have exactly the same problem (no position or geometry data in the reply) This looks like a bug to me but if there is something i am doing wrong thanks to advise

313
William Bishop
Mironeer
B
Brenno Vicario NicolauNew Here
asked in Developer platform and APIs
Exchange authorization code with access token

Just to give some context, I’m not a developer, but I have worked with other APIs before, including OAuth 2.0.I’ve tried to pass the client_secret, code, and redirect_uri as query params, the client_id, and client_secret as body params, and the accept and content-type headers with application/json and application/x-www-form-urlencoded, respectively.I've also tried to do everything as body params using application/json in the content-type header and a few slight variations.Nothing seems to work! I always receive the following message:status: 401code: tokenNotProvidedmessage: No authorization data was found on the requesttype: errorBy the way, I’m using Make to make the request.Is it me or the https://developers.miro.com/reference/ne-exchange-authorization-code-with-access-token could be improved?

293
B
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

7111
Horea Porutiu
Mironeer
C
Chandra Sekhar TBeginner
posted in Developer platform and APIs
how to create clickable button / shape in miro frame

Hi, we want to use Miro board for online course where on click of a button on a frame should execute script. May i know if this is possible in Miro i.e adding a clcikable event on a shape

17466
Eca
Mironeer
T
tomoyoNew Here
asked in Developer platform and APIs
fullLicensesPurchased value in Get organization info API and full license in Get organization members API

Hello,We use “fullLicensesPurchased” value in Get organization info API to get total number of paid license in a org.And we use “license=full” param in Get organization members API to count the number of paid license allocated to users.However, we found the case where total of “license=full” members are greater than the value of “fullLicensesPurchased” in some of our customers Enterprise account. If anyone know the reason of this mis-match, kindly let me know.

111
William Bishop
Mironeer
A
Arailym NurtayevaNew Here
asked in Developer platform and APIs
There are difficulties logging into MIRO

There are difficulties logging into MIRO. Every time I log into the program I have to take a survey. Why?I'm attaching an example 

152
A
Matthias.Cullmann
Matthias.CullmannContributor
posted in Developer platform and APIs
PATCH //miro.com/api/v1/scim/Users userName not unique

Trying to update an existing user as of https://developers.miro.com/docs/users#update-user-attribute-by-idIf the taget userName belongs to a deleted account, I get …{  "schemas" : [ "urn:ietf:params:scim:api:messages:2.0:Error" ],  "status" : "400",  "scimType" : "invalidValue",  "detail" : "User name '*******@baloise.com' is invalid: 'not unique'"} You can reproduce this with the user ID 3074457348934407798. The UPN can not be changed to the baloise.com email domain. Expected behaviour: a deleted account does not count as duplicate and it is possible to reuse UPN’s of deleted accounts.

2606
V
A
aes256Beginner
asked in Developer platform and APIs
Display bug with large shapes becoming more squared

Hi all,since some time I am experiencing roundish shapes that are very large to be displayed as more squared, e.g. this selected circular shape is displayed like a squared shape instead of its actual shape.It happens not reliably but very often once the board is loaded and I start editing shapes that lie within the shapes on my board with a lot of items on it (4000).When the shape is edited (but not just moved around) it returns to its correct shape.Happy to help out with logs and stuff.Cheers

262
A
O
OlehBeginner
asked in Developer platform and APIs
I don't see my app on a toolbar

Unexpectedly I don’t have my app on a toolbar. I had it but now I don’t. I don’t understand why( I have already tried all teams and boards and even different browsers but still can’t find my app.And I see here https://miro.com/app/settings/team/3458764611114804267/apps-and-integrationsthat the app is installed. Can anyone help me, please ?

8711
O
Kiron Bondale
Kiron BondaleVolunteer Community Moderator
asked in Developer platform and APIs
Simple random number generator?

Would there be a quick and dirty way to create a random number widget/addin which could be used for things like simulating a coin flip or rolling a dice?  Right now, I’m using an external URL to Google Dice but would prefer something which didn’t require learners to jump out of their class boards. Thanks! Kiron

1423845
ElvaMiro
Mironeer
A
Amir Ben AriBeginner
asked in Developer platform and APIs
App MetadataData / Item Metadata persistence when duplicating board not working as expected?

Hey everyone,Following this documentation about Storage, I might not understand it correctly or it may not be working as expected.Regarding App Metadata and Item Metadata, for both it says:How is it stored? → Per board, per app (and per board Item for Item metadata).If I make a copy of a board, will the data persist? → for App Metadata and Item Metadata it is marked with a V, and for collection X. It sounds somewhat contradictory to me.. but I expected that when I duplicate a board, both metadatas (App and Item) will be copied from board to board.I tried to test it. I’m developing a Miro App which upserts metadata upon icon click, where metadataKey=”key”. It also have a Shape with metadata. Both holding {“hello”:”world”}.I then went to the list of boards. Selected it, and then clicked on Duplicate.In the new board, when the App loads - it doesn’t see any previous App metadata (via getAppMetadata(‘key’)). And the Shape .getMeatadata() also returns empty.[Note: As as developer, I’ve test

451
Horea Porutiu
Mironeer
M
Maximilian HallettNew Here
asked in Developer platform and APIs
Connection Lines Size

A small question that probably doesn't have a solution yet. Is there way to get around the scaling parameters for the connection lines feature? I want to make my lines thicker in appearance because of the scales that I am working within my Miro Board. Subsequently my connection lines are thin in appearance even when set to the maximum thickness.

19624
S
B
Bradley ButcherNew Here
asked in Developer platform and APIs
App initizalization failure

The board is just loading and says something about the system failure. Does anyone have this problem now? 

10993
Eca
Mironeer
R
rahul.podNew Here
asked in Developer platform and APIs
Facing issues with authorization in my Django app

I am facing authorization issues with my django app. Context: I have a django app that provides an option for the users to authorize their miro accounts and access their miro boards within the app. It has the following view for authorization and callbacks: @login_requireddef miro_authorize(request):    profile = request.user.profile     if not profile.miro_client_id or not profile.miro_client_secret:        messages.error(request, "Please update your Miro Client ID and Client Secret in your profile.")        return redirect('profile')       # Redirect the user to Miro's OAuth2 authorization page    redirect_uri = settings.MIRO_REDIRECT_URI    scope = "boards:write boards:read"     miro_auth_url = f"https://miro.com/oauth/authorize?response_type=code&amp;client_id={profile.miro_client_id}&amp;redirect_uri={redirect_uri}&amp;scope={scope}"       return redirect(miro_auth_url) @login_requireddef miro_callback(request):    code = request.GET.get('code')    profile = request.user.profile  

571
Ruslan Kotowski
Mironeer
T
Tamara DelicNew Here
asked in Developer platform and APIs
Transparent Frame with Rest API

Even though, in REST API Reference I found default fillColor for frame is #ffffff ( ‘transparent’ ), I get WHITE frame when created. How to create transparent frame with Rest API? Is it only possible with Web SDK by setting frame fillColor to ‘transparent’?Thank you in advance,Tamara

1003
Horea Porutiu
Mironeer
H
HughMacdonaldNew Here
asked in Developer platform and APIs
Bug: Code block internals change size between editing and viewing

I hope this is the right place to report a bug - I couldn’t find anywhere obvious to do it. When working with code blocks in Miro (I’m using the desktop app in Windows), the font is a slightly different size when editing vs viewing. And when I click off the code block, it calculates the size based on the editing size, and not the viewing size. This only really shows itself from about 25 lines and longer. Here’s an example with 30 lines in a code block While editing:And as soon as I click out to stop editing:The only way I’ve found to fix this is to turn line numbers off and on again, and it resizes to the size it should be

180
H
S
Sayaka HoriguchiBeginner
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?

647
S
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 

281
ElvaMiro
Mironeer
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

1306
V
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 ?

521
Eca
Mironeer
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.

403
godofprogrammer
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

341
William Bishop
Mironeer
Terms & Conditions