Adding MindMap items via REST API?

And if you remove the background color ?

How do I remove the background color? You mean do not supply that parameter at all when creating a new widget?

Thank you for your advice! I do not understand how it worked - but it worked. I removed the “backgoundColor” element completely:
 

https://api.miro.com/v1/boards/uXjVO8_yUTU=/widgets

{

    "style": {

        "fontSize": 14,

        "textAlign": "right"

    },

    "type": "text",

    "text": "<p>New Sample Widget</p>",

    "x": -42,

    "y": 46

}

and then I get in response backgroundColor assigned anyway
Response body:

{

    "id": "3458764523723863156",

    "style": {

        "padding": 0,

        "backgroundOpacity": 1.0,

        "backgroundColor": "#ffffffff",

        "borderColor": "#ffffffff",

        "borderStyle": "normal",

        "borderOpacity": 1.0,

        "borderWidth": 2.0,

        "fontSize": 14,

        "fontFamily": "OpenSans",

        "textColor": "#1a1a1a",

        "textAlign": "right",

        "shapeType": "text_rect"

    },

    "text": "<p>New Sample Widget</p>",

    "x": -42.0,

    "y": 46.0,

    "width": 100.0,

    "scale": 1.0,

    "rotation": 0.0,

    "type": "text",

...

}

but now all the sudden the new widget has a regular-looking background!

Still it would be great for Miro developers to fix API & documentation

Andriy Zhylenko wrote:

Véronique Carbonneau wrote:

And if you remove the background color ?

Thank you for your advice! I do not understand how it worked - but it worked. I removed the “backgoundColor” element completely:
 

https://api.miro.com/v1/boards/uXjVO8_yUTU=/widgets

{     "style": {         "fontSize": 14,         "textAlign": "right"     },     "type": "text",     "text": "<p>New Sample Widget</p>",     "x": -42,     "y": 46 }

and then I get in response backgroundColor assigned anyway
Response body: {     "id": "3458764523723863156",     "style": {         "padding": 0,         "backgroundOpacity": 1.0,         "backgroundColor": "#ffffffff",         "borderColor": "#ffffffff",         "borderStyle": "normal",         "borderOpacity": 1.0,         "borderWidth": 2.0,         "fontSize": 14,         "fontFamily": "OpenSans",         "textColor": "#1a1a1a",         "textAlign": "right",         "shapeType": "text_rect"     },     "text": "<p>New Sample Widget</p>",     "x": -42.0,     "y": 46.0,     "width": 100.0,     "scale": 1.0,     "rotation": 0.0,     "type": "text", ... }

but now all the sudden the new widget has a regular-looking background!

 

Still it would be great for Miro developers to fix API & documentation

YES :) 

And now I have another challenge: the items I create via script stay glued to their position on the board no matter if I drag their parent node. The nodes created via Miro editor move along with the parent node, which is what expected.

Also the “align child nodes” feature that is available for the “native” MindMap elements does not seem to affect the widgets I add

and this function is not even available for the nodes I create via API. :-(

Any idea how to create “true” MindMap nodes?

I do not have any true knowledge on progamming / coding..
but i’m a good trouble shooter / problme solver and I do understand how it’s all working.. 

So.. my first thought : 

in your transcript, did you put a fix position.. or did you create one with link to the nod parents unfix. 
ex. each new nod is created at the left of the parents and is only linked to the previous node or the next one.. not on your board direclty.. (is it clear?? ) In my head.. it is :P 

Véronique Carbonneau wrote:

Andriy Zhylenko wrote:

Véronique Carbonneau wrote:

And if you remove the background color ?

Thank you for your advice! I do not understand how it worked - but it worked. I removed the “backgoundColor” element completely:
 

https://api.miro.com/v1/boards/uXjVO8_yUTU=/widgets

{     "style": {         "fontSize": 14,         "textAlign": "right"     },     "type": "text",     "text": "<p>New Sample Widget</p>",     "x": -42,     "y": 46 }

and then I get in response backgroundColor assigned anyway
Response body: {     "id": "3458764523723863156",     "style": {         "padding": 0,         "backgroundOpacity": 1.0,         "backgroundColor": "#ffffffff",         "borderColor": "#ffffffff",         "borderStyle": "normal",         "borderOpacity": 1.0,         "borderWidth": 2.0,         "fontSize": 14,         "fontFamily": "OpenSans",         "textColor": "#1a1a1a",         "textAlign": "right",         "shapeType": "text_rect"     },     "text": "<p>New Sample Widget</p>",     "x": -42.0,     "y": 46.0,     "width": 100.0,     "scale": 1.0,     "rotation": 0.0,     "type": "text", ... }

but now all the sudden the new widget has a regular-looking background!

 

Still it would be great for Miro developers to fix API & documentation

YES :) 

I thinks the problem is here : "x": -42.0,     "y": 46.0,  

The problem is that even if I do not supply (x;y) during the request to create a widget, they get assigned automatically - and the item stays “glued”

 

Sending POST request to https://api.miro.com/v1/boards/uXjVO61LItE=/widgets

JSON data:  {
    "style": {
        "fontSize": 14,
        "textAlign": "right"
    },
    "type": "text",
    "text": "<p>New Sample Widget #2</p>"
}

received status code 201 
Response body:  {
    "id": "3458764524067109504",
    "style": {
        "padding": 0,
        "backgroundOpacity": 1.0,
        "backgroundColor": "#ffffffff",
        "borderColor": "#ffffffff",
        "borderStyle": "normal",
        "borderOpacity": 1.0,
        "borderWidth": 2.0,
        "fontSize": 14,
        "fontFamily": "OpenSans",
        "textColor": "#1a1a1a",
        "textAlign": "right",
        "shapeType": "text_rect"
    },
    "text": "<p>New Sample Widget #2</p>",
    "x": 0.0,
    "y": 0.0,
    "width": 100.0,
    "scale": 1.0,
    "rotation": 0.0,
    "type": "text",
    "capabilities": {
        "editable": true
    }
}
 

It seems that through API I cannot just create a widget, attached to another widget - I have to create an “independent” widget first and then link it to its parent using “line” item.

@Andriy Zhylenko 

Unfortunately - The API and SDK do not support mind map widget/item types. 

Thanks!

Miro team - do you have specific plans to fix it in API v2?

@Andriy Zhylenko 
In developer documentation site you’ll find “Roadmap” in the upper right. 
 

Look under released and in progress and if its not there look to see if its requested. If it isnt create a request card. If it requested, up vote it. 

Here is the feature request for CRUD mindmaps - this is your need. I suggest you upvote it. 
https://portal.productboard.com/bs3msuyjdbfr8dfxd84wngpn/c/39-crud-mindmap?utm_medium=social&utm_source=portal_share

Finally I can see that this feature is “in progress” status! Any idea when is the planned release date? 

Hi @truemetal,

Thank you for reaching out.

As you mention, CRUD support for the MindMap board item through the Miro Web SDK is in progress.
Unfortunately, we cannot commit to a planned release date yet.

Best,

marco

Technical writer | Developer support | DevX 

https://developers.miro.com/reference/api-reference

@Andriy Zhylenko 

Hi.
I also want add items with script.

How did you do so?

I used API v1, where it was still possible. But AFAIK now they turned it off. The good news is that supposedly support for Mindmaps in API v2 is coming sometime in the next year

Hey @Andriy Zhylenko, that’s right! We’re working on adding support for Mindmaps in our V2 REST API in the coming months (and likely sooner for the Web SDK)!

We’ll be sure to update this thread once we have more to share. 😊