Create shape item

post

https://api.miro.com/v2/boards/{board_id}/shapes

Adds a shape item to a board.

Required scope

Rate limiting

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

board_id

string

required

Unique identifier (ID) of the board where you want to create the item.

Body Params

data

object

Contains shape item data, such as the content or the type of the shape.

style

object

Contains information about the shape style, such as the border color or opacity.

position

object

Contains information about the item's position on the board, such as its x coordinate, y coordinate, and the origin of the x and y coordinates.

geometry

object

Contains geometrical information about the item, such as its width or height.

parent

object

Contains information about the parent this item must be attached to. A maximum of 1000 items can be attached to a frame. Passing null for parent.id directly attaches an item to the canvas.

Responses

Language

Credentials

Bearer

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Shape item created

400Malformed request

404Not found

429Too many requests