update-frame-item
Modify a frame on a Miro board by updating its title, position, dimensions, or style. Use board and frame IDs to target specific frames for customization.
Instructions
Update a frame on a Miro board based on the data, style, or geometry properties provided in the request body
Input Schema
Name | Required | Description | Default |
---|---|---|---|
boardId | Yes | Unique identifier (ID) of the board where you want to update the frame | |
data | No | The updated content and configuration of the frame | |
geometry | No | Updated dimensions of the frame | |
itemId | Yes | Unique identifier (ID) of the frame that you want to update | |
position | No | Updated position of the frame on the board | |
style | No | Updated style configuration of the frame |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"boardId": {
"description": "Unique identifier (ID) of the board where you want to update the frame",
"type": "string"
},
"data": {
"additionalProperties": false,
"description": "The updated content and configuration of the frame",
"properties": {
"format": {
"description": "Format of the frame. Only 'custom' is supported currently.",
"type": "string"
},
"showContent": {
"description": "Hide or reveal the content inside a frame (Enterprise plan only).",
"type": "boolean"
},
"title": {
"description": "Title of the frame. This title appears at the top of the frame.",
"type": "string"
},
"type": {
"description": "Type of the frame. Only 'freeform' is supported currently.",
"type": "string"
}
},
"type": "object"
},
"geometry": {
"additionalProperties": false,
"description": "Updated dimensions of the frame",
"properties": {
"height": {
"description": "Height of the frame",
"type": "number"
},
"width": {
"description": "Width of the frame",
"type": "number"
}
},
"type": "object"
},
"itemId": {
"description": "Unique identifier (ID) of the frame that you want to update",
"type": "string"
},
"position": {
"additionalProperties": false,
"description": "Updated position of the frame on the board",
"properties": {
"x": {
"description": "X coordinate of the frame",
"type": "number"
},
"y": {
"description": "Y coordinate of the frame",
"type": "number"
}
},
"required": [
"x",
"y"
],
"type": "object"
},
"style": {
"additionalProperties": false,
"description": "Updated style configuration of the frame",
"properties": {
"fillColor": {
"description": "Fill color for the frame. Hex values like #f5f6f8, #d5f692, etc.",
"type": "string"
}
},
"type": "object"
}
},
"required": [
"boardId",
"itemId"
],
"type": "object"
}