Skip to main content

Developer platform and APIs

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

  • 1,073 Topics
  • 3,327 Replies
1068 Topics
W
Will TatumNew Here
posted in Developer platform and APIs
Once the app is submitted, how long does it take to review it?

Once the app is submitted, how long does it take to review it?

687
C
Mironeer
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).

1078
T
F
Fadi WissaNew Here
asked in Developer platform and APIs
Boards not appearing via REST API

Created some new boards today.These boards are not appearing via REST API (https://api.miro.com/v2/boards), even hours after creation.The account that installed the app is the same account that created the boards, and I can access such boards by ID if I specifically request them via REST API and they also appear if I use the “team_id” query string parameter, as suggested in the API documentation. But in such case I cannot use the “query” query string parameter, which I need to use. According to the same documentation the new boards should appear within seconds without the “team_id” parameter.The account we are developing for has around 1,149 boards, but I don’t believe that should break the API.

682
F
S
Sebastian KsollNew Here
asked in Developer platform and APIs
Problem: presentation mode of an embedded board

Hello everyone,Since yesterday, the presentation mode of an embedded board on a website is no longer working. Do you already know about this issue? I have already tested it with a test board. The board opens, and I can see the frame, but not in presentation mode. It’s important to me to be able to navigate from frame to frame using the arrow keys.I have tried it on both a Windows and Mac system and with different boards and different explorers.Can anyone replicate the problem or explain what the issue might be? For testing, I used the standard HTML code and inserted the iFrame code of the board into the body. <!DOCTYPE html><html lang="de"><head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Beispielseite mit iframe</title></head><body> <h1>Willkommen auf meiner Seite</h1> <p>Hier ist ein eingebettetes iframe:</p><iframe> </iframe&

1323
N
K
kondoBeginner
asked in Developer platform and APIs
About App MetadataData

Hi there, does AppMetadata store data per board or is the data shared across different boards?I ‘m not able to understand the documentation as it says that it is stored per board, but the data persist when making a copy of a board.

444
Q
K
kirkeskovBeginner
asked in Developer platform and APIs
Miro web SDK metadata not working on images

Hi there,I’ve been trying to add metadata to my images, however it seems like it’s not supported/updated for some reason.Ways to reproduce:1. Empty board - add a single image to the board.2. Console:const [item] = await miro.board.get();await item.setMetadata('test', 'data')await item.getMetadata()You will see the meta data present on the single item that is on the board - an image.3. Then close the board and re-open it.4. Console:const [item] = await miro.board.get();await item.getMetadata()5. It is now empty, no data is saved on the item :(If I try the exact same thing with a Card, it works just fine.If I try the exact same thing with a Sticky Note - it also doesn’t work.I’ve also tried to do item.sync() to see if that would lead anywhere, but it also doesn’t.It seems like it’s not saving across sessions? If there’s something I’m missing then this is not documented very well in the SDK docs.

363
Horea Porutiu
Mironeer
C
Chris UhrigBeginner
asked in Developer platform and APIs
Set Space via Rest API

Hi there, I am currently facing the issue that I want to copy a board and store it in a specific Space. Is this somehow possible? I can’t find any reference about it, even though it seems like a very simple use case.  Otherwise, this would be highly requested, as we want to maintain our desired structure. Kind regardsChris 

662
C
S
SteveASmyleNew Here
asked in Developer platform and APIs
Refresh Token missing from access token payload

Hello, I do not receive a refresh token when generating an access token to the oauth token endpoint. Have I missed some setting somewhere?Sample response:And the authorization URL looks like this:Thank you

221
William Bishop
Mironeer
M
mratabeyNew Here
asked in Developer platform and APIs
How can I get/set estimate value in cards using WEB SDK?

I tried to find how can I control the Estimate field in Miro Cards but it seems there is no described method for it. Can someone please comment?

442
Q
S
Sebastian KurzNew Here
asked in Developer platform and APIs
Jira Integration (Board) - Using Epic Link as Swimlane

I want to use Epic Link as swimlanes.Even though the Epic Link info is available on the Cards, it is not usable as swimlane.  

290
S
I
IrzadNew Here
asked in Developer platform and APIs
VMS - Initial Prototype

This the initial prototypes for VMS

181
Eca
Mironeer
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" }, "

922
GodMode9
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!

653
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  

262
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

321
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 (>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

473
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?

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

20986
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.

191
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 

212
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.

2756
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

412
A
O
OlehContributor
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 ?

13611
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

1438145
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

471
Horea Porutiu
Mironeer
Terms & Conditions