# Miro Your Toolhouse AI Worker can connect to Miro using 77 specialized tools. ## Auth Connection This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under [Auth Connections](https://toolhouse.app/auth-connections?authkit_slugs=miro). ## Tools (77) ### `Miro Attach Tag To Item` Integration name: **MIRO\_ATTACH\_TAG\_TO\_ITEM** Tool to attach an existing tag to a specific item on a Miro board. Use when you need to associate a tag with an item after confirming the board, item, and tag IDs. Note that card and sticky note items can have up to 8 tags. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------------------------------------------- | | `tag_id` | string | ✅ | `"3458764654995170028"` | Unique identifier of the tag to attach to the item. | | `item_id` | string | ✅ | `"3458764654995933200"` | Unique identifier of the item to attach the tag to. Card and sticky note items can have up to 8 tags. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier of the board containing the item. | *** ### `Miro Create App Card Item` Integration name: **MIRO\_CREATE\_APP\_CARD\_ITEM** Tool to add an app card item to a board. Use when you need to push a rich preview card with custom fields into a Miro board. Returns the created card; the card ID is nested under data.id in the response, not at the top level. Burst writes may trigger HTTP 429; honor the Retry-After header before retrying. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | ---------------------------------------------------- | | `data` | object | ✅ | — | Payload data for the app card | | `style` | object | | — | Styling options for an app card item. | | `parent` | object | | — | Parent frame reference for nesting an app card item. | | `board_id` | string | ✅ | `"b1X2Yz3A"` | ID of the board to add the app card to | | `geometry` | object | | — | Geometrical dimensions for an app card item. | | `position` | object | | — | Board position for an app card item. | *** ### `Miro Create Board` Integration name: **MIRO\_CREATE\_BOARD** Tool to create a new board. Use when you need to set up a board with a specific name, description, and policies. Example: "Create a new board named Project Plan". If workspace board quota is reached, returns HTTP 400; use MIRO\_GET\_BOARDS to reuse an existing board instead. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `name` | string | ✅ | `"Project Roadmap"` | Name for the board, length between 1 and 60 characters. | | `policy` | object | | — | Defines permissions and sharing policies for the board. Accepts specific enum values only; invalid values return HTTP 400 with error code 2.0703. Valid `sharingPolicy` values include `private`, `view`, `comment`, `edit`, `team_access`. | | `teamId` | string | | `"345876451234567890"` | Unique identifier (ID) of the team where the board will be created. | | `projectId` | string | | `"098765432109876543"` | Unique identifier (ID) of the project (space) to which the board belongs. | | `description` | string | | `"Board for planning upcoming quarter"` | Description of the board, length between 0 and 300 characters. | *** ### `Miro Create Card Item` Integration name: **MIRO\_CREATE\_CARD\_ITEM** Tool to create a card item on a Miro board. Use when you need to add task cards with titles, descriptions, due dates, and assignees. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------- | | `data` | object | | — | Core data for a card item. | | `style` | object | | — | Styling options for a card item. | | `parent` | object | | — | Parent item reference for nesting a card. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier of the board where the card will be created | | `geometry` | object | | — | Geometrical dimensions for a card item. | | `position` | object | | — | Board position for a card item. | *** ### `Miro Create Connector` Integration name: **MIRO\_CREATE\_CONNECTOR** Tool to create a connector (edge/arrow) that links two existing board items. Use after creating or locating the two endpoint items (shapes/cards/stickies) to establish visual relationships in flowcharts and diagrams. Both start and end items must be specified; connectors cannot be created with loose endpoints. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------------ | | `shape` | string | ✅ | `"straight"` | Shape/style of the connector line. | | `style` | object | | — | Visual styling properties for the connector line and caption. | | `endItem` | object | ✅ | — | Defines the ending point of the connector. Must specify either snapTo or position. | | `board_id` | string | ✅ | `"uXjVN8aJ5Yk="` | Unique identifier of the board where the connector will be created. | | `captions` | array | | — | Array of caption objects to display text along the connector. | | `startItem` | object | ✅ | — | Defines the starting point of the connector. Must specify either snapTo or position. | *** ### `Miro Create Document Item` Integration name: **MIRO\_CREATE\_DOCUMENT\_ITEM** Tool to create a document item on a Miro board by providing a URL to the document. Use when you need to attach a document (PDF, DOC, etc.) to a board from a publicly accessible URL. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | --------------- | ---------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains the document URL and optional title. | | `parent` | object | | — | Parent element reference for hierarchical positioning. | | `board_id` | string | ✅ | `"uXjVOxxxxxx"` | The unique identifier of the board where the document will be created. | | `geometry` | object | | — | Geometric properties with fixed aspect ratio for the document item. | | `position` | object | | — | Positioning information for the document item on the board. | *** ### `Miro Create Document Item Using File From Device` Integration name: **MIRO\_CREATE\_DOCUMENT\_ITEM\_USING\_FILE\_FROM\_DEVICE** Tool to create a document item on a Miro board using a URL to the document. Use when you need to add a document (PDF, DOC, etc.) to a board from a publicly accessible URL. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------ | | `data` | object | | — | Data containing document metadata like title. | | `parent` | object | | — | Parent frame information for the item. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the item. | | `geometry` | object | | — | Geometrical information about the item. | | `position` | object | | — | Position information for the document item on the board. | | `resource` | object | ✅ | — | Document file to upload. Maximum file size: 6 MB. Supported format: PDF. | *** ### `Miro Create Embed Item` Integration name: **MIRO\_CREATE\_EMBED\_ITEM** Tool to create an embed item on a Miro board by providing a URL to embed content (YouTube videos, websites, etc.). Use when you need to add embedded content from external sources to a board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains information about the embed URL. | | `parent` | object | | — | Parent element reference for hierarchical positioning. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the item. | | `geometry` | object | | — | Geometrical information about the embed item. | | `position` | object | | — | Positioning information for the embed item on the board. | *** ### `Miro Create Frame Item` Integration name: **MIRO\_CREATE\_FRAME\_ITEM** Tool to add a frame item to a Miro board. Use frames to group and organize diagram regions (e.g., swimlanes, sections, slides). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains frame-specific properties like title and format. This field is required. | | `style` | object | | — | Styling options for a frame item. | | `parent` | object | | — | Parent item reference for nesting a frame. | | `board_id` | string | ✅ | `"uXjVOcKJl6Y="` | Unique identifier of the board where the frame will be added | | `geometry` | object | | — | Geometrical dimensions for a frame item. | | `position` | object | | — | Board position for a frame item. | *** ### `Miro Create Frame Item2` Integration name: **MIRO\_CREATE\_FRAME\_ITEM2** DEPRECATED: Use MIRO\_CREATE\_FRAME\_ITEM instead. Tool to create a frame on a Miro board. Use when you need to group and organize content into sections or containers. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains frame item data, such as the title, frame type, or frame format. | | `style` | object | | — | Styling options for a frame item. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create a frame. | | `geometry` | object | | — | Geometrical dimensions for a frame item. | | `position` | object | | — | Board position for a frame item. | *** ### `Miro Create Group` Integration name: **MIRO\_CREATE\_GROUP** Tool to create a group on a Miro board by grouping multiple items together. Use when you need to organize related board items (shapes, sticky notes, cards, etc.) into a single logical group. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | -------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains the data with item IDs to be grouped. | | `board_id` | string | ✅ | `"uXjVOfjmfkE="` | Unique identifier (ID) of the board where the group will be created. | *** ### `Miro Create Image Item Using Local File` Integration name: **MIRO\_CREATE\_IMAGE\_ITEM\_USING\_LOCAL\_FILE** Tool to create an image item on a Miro board by uploading a local image file. Use when you need to add an image from the user's device to a board, rather than referencing an external URL. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------------- | | `data` | object | | — | Core data for an image item. | | `parent` | object | | — | Parent item reference for nesting an image. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to create the image item. | | `geometry` | object | | — | Geometrical dimensions for an image item. | | `position` | object | | — | Board position for an image item. | | `resource` | object | ✅ | — | Image file to upload. Supported formats: PNG, JPG, JPEG, GIF, SVG, etc. | *** ### `Miro Create Items In Bulk` Integration name: **MIRO\_CREATE\_ITEMS\_IN\_BULK** Tool to create multiple items on a Miro board in a single request. Use when you need to add 1-20 items (text, sticky notes, shapes, cards, frames, etc.) efficiently. Items are created atomically in one API call. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------------ | | `items` | array | ✅ | — | List of items to create. You can create 1 to 20 items per request. | | `board_id` | string | ✅ | `"uXjVKv0eFoo="` | Unique identifier of the board where items will be created. | *** ### `Miro Create Mindmap Node Experimental` Integration name: **MIRO\_CREATE\_MINDMAP\_NODE\_EXPERIMENTAL** Tool to create a mind map node on a Miro board. Use when building mind maps or organizing ideas visually in a hierarchical structure. This is an experimental endpoint. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------- | | `data` | object | ✅ | — | Core mind map node data including the node view with content. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to create the mind map node. | | `geometry` | object | | — | Geometry for the mind map node. | | `position` | object | | — | Position for the mind map node on the board. | *** ### `Miro Create Shape Item` Integration name: **MIRO\_CREATE\_SHAPE\_ITEM** DEPRECATED: Use MIRO\_MIRO\_CREATE\_SHAPE\_ITEM2 instead. Tool to create a native Miro shape item (diagram node) on a board. Use when building diagrams, flowcharts, or architecture diagrams with shapes that can then be connected via MIRO\_CREATE\_CONNECTOR. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | --------------------------------------------------------------- | | `data` | object | ✅ | — | Core shape data including content text and shape type. | | `style` | object | | — | Styling options for a shape item. | | `parent` | object | | — | Parent item reference for nesting a shape. | | `board_id` | string | ✅ | `"uXjVKv0eFoo="` | Unique identifier of the board where the shape will be created. | | `geometry` | object | | — | Geometrical dimensions for a shape item. | | `position` | object | | — | Board position for a shape item. | *** ### `Miro Create Shape Item2` Integration name: **MIRO\_CREATE\_SHAPE\_ITEM2** Tool to create a shape item on a Miro board. Use when you need to add shapes (basic or flowchart) to a board with specific styling and positioning. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------- | | `data` | object | | — | Core data for a shape item. | | `style` | object | | — | Styling options for a shape item. | | `parent` | object | | — | Parent frame information for the shape item. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the item. | | `geometry` | object | | — | Geometrical information about the shape item. | | `position` | object | | — | Position information for the shape item. | *** ### `Miro Create Sticky Note Item` Integration name: **MIRO\_CREATE\_STICKY\_NOTE\_ITEM** Tool to create a sticky note item on a Miro board. Use when you need to add a new sticky note with customizable content, color, shape, and position. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | object | | — | Contains sticky note item data, such as the content or shape of the sticky note. | | `style` | object | | — | Contains information about the style of a sticky note item, such as the fill color or text alignment. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the item. | | `geometry` | object | | — | Contains geometrical information about the item. You can set either the width or height. You cannot set both the width and height at the same time. | | `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. | *** ### `Miro Create Tag` Integration name: **MIRO\_CREATE\_TAG** Tool to create a new tag on a Miro board. Use when you need to add a new tag with a specific title and color to categorize board items. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ---------------- | ------------------------------------------------------------------------------------------------- | | `title` | string | ✅ | `"to do"` | Text of the tag. Case-sensitive. Must be unique within the board. | | `boardId` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the tag. | | `fillColor` | string | | `"blue"` | Fill color for the tag. Choose from predefined color options. Defaults to 'red' if not specified. | *** ### `Miro Create Text Item` Integration name: **MIRO\_CREATE\_TEXT\_ITEM** Tool to create a text item on a Miro board. Use when you need to add text content to a board, such as labels, notes, or annotations. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | ---------------------------------------------------------------------- | | `data` | object | ✅ | — | Contains text item data, such as the content. | | `style` | object | | — | Styling options for a text item. | | `parent` | object | | — | Parent item reference for nesting a text item. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to create the item. | | `geometry` | object | | — | Geometrical dimensions for a text item. | | `position` | object | | — | Board position for a text item. | *** ### `Miro Delete App Card Item` Integration name: **MIRO\_DELETE\_APP\_CARD\_ITEM** Tool to delete an app card item from a board. Use when you need to remove an app card item created by your app after it is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | ------------------------------------------------------------ | | `item_id` | string | ✅ | `"item456"` | Unique identifier of the app card item to delete. | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board containing the app card item. | *** ### `Miro Delete Card Item` Integration name: **MIRO\_DELETE\_CARD\_ITEM** Tool to delete a card item from a board. Use when you need to remove a card item from a Miro board after it is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444206061"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Delete Connector` Integration name: **MIRO\_DELETE\_CONNECTOR** Tool to delete a specific connector from a board. Use when you need to remove a connector (edge/arrow) between board items after confirming its board and connector IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ----------------------- | -------------------------------------------------------------------------------- | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the connector. | | `connector_id` | string | ✅ | `"3458764655444206087"` | Unique identifier (ID) of the connector that you want to delete. | *** ### `Miro Delete Document Item` Integration name: **MIRO\_DELETE\_DOCUMENT\_ITEM** Tool to delete a document item from a board. Use when you need to remove a document item (e.g., PDF or image) that is no longer relevant. Example: "Delete the document item with ID 'item456' from board 'board123'." #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | ------------------------------------------------------------ | | `item_id` | string | ✅ | `"item456"` | Unique identifier of the document item to delete. | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board containing the document item. | *** ### `Miro Delete Embed Item` Integration name: **MIRO\_DELETE\_EMBED\_ITEM** Tool to delete an embed item from a board. Use when you need to remove an embedded content item (e.g., YouTube video, website) that is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444219535"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Delete Frame Item` Integration name: **MIRO\_DELETE\_FRAME\_ITEM** Tool to delete a frame item from a Miro board. Use when you need to remove a frame that groups or organizes content on the board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444206155"` | Unique identifier (ID) of the frame that you want to delete. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the frame. | *** ### `Miro Delete Group` Integration name: **MIRO\_DELETE\_GROUP** Tool to delete a group from a board. Use when you need to remove a group and optionally its items. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------- | :------: | ----------------------- | ------------------------------------------------------------------------------------------ | | `board_id` | string | ✅ | `"uXjVOfjmfkE="` | Unique identifier (ID) of the board. | | `group_id` | string | ✅ | `"3858764584681774600"` | Unique identifier (ID) of the group. | | `delete_items` | boolean | ✅ | `false` | Indicates whether the items should be removed. Set to `true` to delete items in the group. | *** ### `Miro Delete Image Item` Integration name: **MIRO\_DELETE\_IMAGE\_ITEM** Tool to delete an image item from a board. Use when you need to remove an image that is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764642917707441"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Delete Item` Integration name: **MIRO\_DELETE\_ITEM** Tool to delete a specific item from a board. Use when you need to remove an item (e.g., shape, sticky note) after confirming its board and item IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | --------------------------------------------------- | | `item_id` | string | ✅ | `"item456"` | Unique identifier of the item to delete. | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board containing the item. | *** ### `Miro Delete Mindmap Node Experimental` Integration name: **MIRO\_DELETE\_MINDMAP\_NODE\_EXPERIMENTAL** Tool to delete a mind map node from a board. Use when you need to remove a mind map node after confirming its board and item IDs. This is an experimental endpoint. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655058733473"` | Unique identifier (ID) of the mind map node that you want to delete. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the mind map node. | *** ### `Miro Delete Shape Item` Integration name: **MIRO\_DELETE\_SHAPE\_ITEM** Tool to delete a shape item from a board. Use when you need to remove a specific shape that is no longer needed after confirming its board and item IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444219462"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Delete Sticky Note Item` Integration name: **MIRO\_DELETE\_STICKY\_NOTE\_ITEM** Tool to delete a sticky note item from a board. Use when you need to remove a sticky note that is no longer needed. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444040865"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Delete Tag` Integration name: **MIRO\_DELETE\_TAG** Tool to delete a specific tag from a board. Use when you need to remove a tag after confirming its board and tag IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------------- | | `tag_id` | string | ✅ | `"3458764654997615216"` | Unique identifier (ID) of the tag that you want to delete. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to delete a specific tag. | *** ### `Miro Delete Text Item` Integration name: **MIRO\_DELETE\_TEXT\_ITEM** Tool to delete a text item from a board. Use when you need to remove a text item after confirming its board and item IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444206052"` | Unique identifier (ID) of the item that you want to delete. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to delete the item. | *** ### `Miro Get All Groups` Integration name: **MIRO\_GET\_ALL\_GROUPS** Tool to retrieve all groups on a Miro board with cursor-based pagination. Use when you need to list all groups and their associated items on a board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------------- | ---------------------------------------------------------------------------------------------------------- | | `limit` | integer | | `10` | The maximum number of groups to return at one time. Default is 10, minimum is 10, maximum is 50. | | `cursor` | string | | `"Y3Vyc29yOjE="` | Cursor for pagination. Use the cursor value from a previous response to retrieve the next page of results. | | `board_id` | string | ✅ | `"uXjVOfjmfkE="` | Unique identifier (ID) of the board. | *** ### `Miro Get App Card Item2` Integration name: **MIRO\_GET\_APP\_CARD\_ITEM2** Tool to retrieve a specific app card item by its ID from a Miro board. Use when you need to get the details of an existing app card item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444219403"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Board` Integration name: **MIRO\_GET\_BOARD** DEPRECATED: Use MIRO\_GET\_SPECIFIC\_BOARD instead. Tool to retrieve details of a specific board. Use when you have a board ID and need to fetch its metadata. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------ | ------------------------------------------ | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board to retrieve | *** ### `Miro Get Board Items` Integration name: **MIRO\_GET\_BOARD\_ITEMS** Tool to list items on a Miro board (shapes, stickies, cards, etc.) with pagination. Use when you need to page through board elements for analytics or reporting. Re-fetch before bulk updates to avoid stale item IDs. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `type` | string | | `"sticky_note"` | Filter by item type. Note: 'connector' is not supported; use the separate Get Connectors action instead. | | `limit` | integer | | `50` | Maximum number of items to return per page (10-50) | | `cursor` | string | | `"eyJjdXJzb3IiOiIxMjM0NTY3In0"` | Cursor for paginating results; use the value from a prior response. Loop: pass the cursor from each response into the next call; stop when cursor is null (all items retrieved). | | `board_id` | string | ✅ | `"b1X2Yz3A"` | Unique identifier of the board to retrieve items from | *** ### `Miro Get Board Members` Integration name: **MIRO\_GET\_BOARD\_MEMBERS** Tool to retrieve a list of members for a board. Use when you need to list all users with access to a board after confirming its ID. Results are scoped to the authenticated user's permissions; members or boards inaccessible to that user will not appear in the response. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ---------------- | --------------------------------------------------------- | | `limit` | integer | | `50` | Number of results per page (max 100). | | `cursor` | string | | `"Y3Vyc29yOjE="` | Cursor for pagination, used to retrieve subsequent pages. | | `board_id` | string | ✅ | `"board_abc123"` | Unique identifier of the board. | *** ### `Miro Get Boards` Integration name: **MIRO\_GET\_BOARDS** DEPRECATED: Use MIRO\_MIRO\_GET\_BOARDS2 instead. Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords. Only boards accessible to the authenticated user are returned. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ---------------------- | ---------------------------------------------------------------------------------------------------- | | `sort` | string | | `"last_modified"` | Sort order of the results. | | `limit` | integer | | `50` | Number of boards to return per page (1-50). Values above 50 cause a 400 error. | | `owner` | string | | `"user_abc123"` | Filter boards by owner user ID. | | `query` | string | | `"Roadmap"` | Search query to filter boards by name. | | `offset` | integer | | `0` | Offset for pagination. Increment by `limit` value until results are exhausted to retrieve all pages. | | `team_id` | string | | `"345876451234567890"` | Filter boards by team ID. | | `project_id` | string | | `"098765432109876543"` | Filter boards by project (space) ID. | *** ### `Miro Get Boards2` Integration name: **MIRO\_GET\_BOARDS2** Tool to retrieve accessible boards with optional filters. Use when you need to list or search boards by team, project, owner, or keywords with full pagination support. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------ | ------- | :------: | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `sort` | string | | `"last_modified"` | Sort order in which you want to view the result set. Options `last_created` and `alphabetically` are applicable only when you search for boards by team. Values: `default`, `last_modified`, `last_opened`, `last_created`, `alphabetically`. Default: `default` (If `team_id` is present, `last_created`. Otherwise, `last_opened`). | | `limit` | integer | | `20` | Maximum number of boards to retrieve (1-50). Default: 20 | | `owner` | string | | `"3074457353169356300"` | Retrieves a list of boards that belong to a specific owner ID. You must pass the owner ID (for example, 3074457353169356300), not the owner name. You can use the 'owner' parameter with the `query` parameter to narrow down the board search results. Note that if you pass the `team_id` in the same request, the `owner` parameter is ignored. | | `query` | string | | `"beta"` | Retrieves a list of boards that contain the query string provided in the board name or board description. You can use the `query` parameter with the owner parameter to narrow down the board search results. | | `offset` | integer | | `0` | Zero-based offset of the first item in the collection. Default: 0 | | `team_id` | string | | `"345876451234567890"` | The team\_id for which you want to retrieve the list of boards. If this parameter is sent in the request, the `query` and `owner` parameters are ignored. | | `project_id` | string | | `"098765432109876543"` | The `project_id` for which you want to retrieve the list of boards. If this parameter is sent in the request, the `query` and `owner` parameters are ignored. | *** ### `Miro Get Card Item` Integration name: **MIRO\_GET\_CARD\_ITEM** Tool to retrieve a specific card item from a Miro board. Use when you need to fetch details of an existing card item by its ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444219402"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Connector` Integration name: **MIRO\_GET\_CONNECTOR** Tool to retrieve a specific connector by its ID. Use when you need details about an existing connector on a board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------------------------------- | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific connector. | | `connector_id` | string | ✅ | `"3458764575781967065"` | Unique identifier (ID) of the connector that you want to retrieve. | *** ### `Miro Get Connectors` Integration name: **MIRO\_GET\_CONNECTORS** Tool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `limit` | integer | | `10` | Maximum number of results to return per call (10 to 50). Defaults to 10. | | `cursor` | string | | `"foo"` | Cursor for pagination to retrieve the next page of connectors. Pass the cursor returned by the previous response to fetch the next page; when the response returns a null cursor, all pages have been retrieved. | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board to retrieve connectors from. | *** ### `Miro Get Document Item` Integration name: **MIRO\_GET\_DOCUMENT\_ITEM** Tool to retrieve a specific document item from a Miro board by its ID. Use when you need to get details about an existing document item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655059464823"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Embed Item` Integration name: **MIRO\_GET\_EMBED\_ITEM** Tool to retrieve a specific embed item from a board by its ID. Use when you need details of an existing embedded content item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444206019"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Frame Item` Integration name: **MIRO\_GET\_FRAME\_ITEM** Tool to retrieve a specific frame item from a Miro board. Use when you need to fetch details of an existing frame by its ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------- | | `item_id` | string | ✅ | `"3458764655444219664"` | Unique identifier (ID) of the frame that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board that contains the frame that you want to retrieve | *** ### `Miro Get Group By Id` Integration name: **MIRO\_GET\_GROUP\_BY\_ID** Tool to retrieve a specific group by its ID. Use when you need to get details about a group on a Miro board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------ | | `board_id` | string | ✅ | `"uXjVOfjmfkE="` | Unique identifier (ID) of the board. | | `group_id` | string | ✅ | `"3858764584681774600"` | Unique identifier (ID) of the group. | *** ### `Miro Get Image Item` Integration name: **MIRO\_GET\_IMAGE\_ITEM** Tool to retrieve a specific image item from a board. Use when you need to get details about an existing image item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764575781731716"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Item Tags` Integration name: **MIRO\_GET\_ITEM\_TAGS** Tool to retrieve tags attached to a specific item on a Miro board. Use when you need to get the tags associated with a particular item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------- | | `item_id` | string | ✅ | `"3458764541654614172"` | Unique identifier of the item to retrieve tags from. | | `board_id` | string | ✅ | `"uXjVP4I8Wj8="` | Unique identifier of the board containing the item. | *** ### `Miro Get Mindmap Node Experimental` Integration name: **MIRO\_GET\_MINDMAP\_NODE\_EXPERIMENTAL** Tool to retrieve a specific mind map node from a board. Use when you need to get details about a mind map node by its ID. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764654995948672"` | Unique identifier (ID) of the mind map node that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a mind map node. | *** ### `Miro Get Mindmap Nodes Experimental` Integration name: **MIRO\_GET\_MINDMAP\_NODES\_EXPERIMENTAL** Tool to retrieve mind map nodes from a Miro board. Use when you need to access the structure and content of mind maps on a board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | | `limit` | string | | `"10"` | Maximum number of results returned. | | `cursor` | string | | `"eyJjdXJzb3IiOiIxMjM0NTY3In0"` | Points to the next portion of the results set. Use the cursor value from a previous response to retrieve the next page. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve mind map nodes. | *** ### `Miro Get Oembed` Integration name: **MIRO\_GET\_OEMBED** Tool to retrieve oEmbed data for a Miro board. Use when you need to generate embeddable HTML code for a board or get board metadata in oEmbed format. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------- | :------: | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | string | ✅ | `"https://miro.com/app/board/uXjVJ_fzYUs="` | The URL pointing to the Miro board resource to return as oEmbed data. Must be a valid Miro board URL (e.g., ). | | `format` | string | | `"json"` | Specifies the return format of the response. Only 'json' is supported. Defaults to 'json' if not specified. | | `maxwidth` | integer | | `800` | The maximum width available to the embed, in pixels. The oEmbed response will respect this constraint. | | `referrer` | string | | `"https://example.com/page"` | The URL pointing to the source of the request. Used to track where the embed will be displayed. | | `maxheight` | integer | | `600` | The maximum height available to the embed, in pixels. The oEmbed response will respect this constraint. | *** ### `Miro Get Shape Item` Integration name: **MIRO\_GET\_SHAPE\_ITEM** Tool to retrieve a specific shape item from a Miro board by its ID. Use when you need to get details of an existing shape item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444303695"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Specific Board` Integration name: **MIRO\_GET\_SPECIFIC\_BOARD** Tool to retrieve detailed information about a specific board by its ID. Use when you need to fetch complete metadata including team, permissions, owner, and modification details for a board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ---------------- | -------------------------------------------------------------- | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board that you want to retrieve. | *** ### `Miro Get Specific Board Member` Integration name: **MIRO\_GET\_SPECIFIC\_BOARD\_MEMBER** Tool to retrieve details of a specific board member. Use when you have a board ID and board member ID and need to get that member's role and information. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------- | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board to which the board member belongs. | | `board_member_id` | string | ✅ | `"3458764569137445003"` | Unique identifier (ID) of the board member whose role you want to retrieve. | *** ### `Miro Get Specific Item` Integration name: **MIRO\_GET\_SPECIFIC\_ITEM** Tool to retrieve a specific item from a Miro board by its ID. Use when you need details about a particular board item (sticky note, shape, card, frame, etc.). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764575781966992"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Sticky Note Item` Integration name: **MIRO\_GET\_STICKY\_NOTE\_ITEM** Tool to retrieve a specific sticky note item from a board by its ID. Use when you need to get the details of an existing sticky note item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444303666"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro Get Tag` Integration name: **MIRO\_GET\_TAG** Tool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------- | ----------------------------------------------------- | | `tag_id` | string | ✅ | `"tag_123abcXYZ"` | Unique identifier of the tag to retrieve. | | `board_id` | string | ✅ | `"board123"` | Unique identifier of the board where the tag resides. | *** ### `Miro Get Text Item` Integration name: **MIRO\_GET\_TEXT\_ITEM** Tool to retrieve a specific text item from a Miro board by its ID. Use when you need to get the details of an existing text item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------ | | `item_id` | string | ✅ | `"3458764655444303769"` | Unique identifier (ID) of the item that you want to retrieve. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board from which you want to retrieve a specific item. | *** ### `Miro List Board Tags` Integration name: **MIRO\_LIST\_BOARD\_TAGS** Tool to list all tags on a Miro board. Use when you need to discover tag IDs, titles, or colors before performing tag operations. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------- | :------: | ------------------------------- | ------------------------------------------------------------------- | | `limit` | integer | | `50` | Maximum number of tags to return per page (min 1). | | `cursor` | string | | `"eyJjdXJzb3IiOiIxMjM0NTY3In0"` | Cursor for paginating results; use the value from a prior response. | | `board_id` | string | ✅ | `"uXjVKbZpNkg="` | Unique identifier of the board to retrieve tags from. | *** ### `Miro List Organizations` Integration name: **MIRO\_LIST\_ORGANIZATIONS** Retrieves the organization associated with the current access token. Note: Miro's API does not have an endpoint to list all organizations a user has access to. This action uses the /v1/oauth-token endpoint to return the single organization context associated with the authenticated token, along with team and user information. For Enterprise users who need to work with organizations, use organization-specific endpoints like MIRO\_GET\_ORGANIZATION\_MEMBERS which require an org\_id parameter. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. *No parameters required.* *** ### `Miro Share Board` Integration name: **MIRO\_SHARE\_BOARD** Tool to share a board by inviting users via email. Use when you need to grant access to a board by sending email invitations to new members. You can invite up to 20 users per call and assign them roles (viewer, commenter, editor, coowner, or owner). #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `role` | string | | `"viewer"` | Role of the board members being invited. Options: viewer (view only), commenter (view and comment), editor (view, comment, and edit), coowner (full access except changing owner), or owner (full access including changing owner). Note: Inviting users with role 'owner' has the same effect as 'coowner'. | | `emails` | array | ✅ | `["user1@example.com","user2@example.com"]` | Email addresses of the users you want to invite to the board. You can invite up to 20 members per call. | | `message` | string | | `"Join this board to collaborate on our project!"` | Optional message that will be sent in the invitation email to the invited users. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board to which you want to invite members. | *** ### `Miro Update App Card Item2` Integration name: **MIRO\_UPDATE\_APP\_CARD\_ITEM2** Tool to update an app card item on a Miro board. Use when you need to modify properties of an existing app card such as title, description, status, style, position, or geometry. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------- | | `data` | object | | — | Core data for an app card item. | | `style` | object | | — | Styling information for an app card item. | | `parent` | object | | — | Parent frame information for an app card item. | | `item_id` | string | ✅ | `"3458764655444603322"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Geometrical information about an app card item. | | `position` | object | | — | Position information for an app card item. | *** ### `Miro Update Board` Integration name: **MIRO\_UPDATE\_BOARD** Tool to update properties of a specific board. Use when you have a board ID and need to modify its name, description, or permissions policy. Use after confirming the board exists. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ------------- | ------ | :------: | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `name` | string | | `"Project Roadmap Updated"` | New name for the board (1-60 characters) | | `policy` | object | | — | Defines permissions and sharing policies for the board Contains `sharingPolicy` subfield accepting specific enum values (e.g., `private`, `view`, `comment`, `edit`); invalid values return 400. | | `teamId` | string | | `"345876451234567890"` | ID of the team where the board should be placed | | `boardId` | string | ✅ | `"board123"` | Unique identifier (ID) of the board to update | | `projectId` | string | | `"098765432109876543"` | ID of the project (space) to which the board should be added | | `description` | string | | `"Updated board description for Q3 planning"` | New description for the board (up to 300 characters) | *** ### `Miro Update Board Member` Integration name: **MIRO\_UPDATE\_BOARD\_MEMBER** Tool to update the role of a specific board member. Use when you have a board ID and board member ID and need to change that member's permissions or role on the board. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `role` | string | | `"editor"` | Role of the board member. Can be viewer (view only), commenter (view and comment), editor (view, comment, and edit), coowner (full access except changing owner), or owner (full access including changing owner). | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board for which you want to update the role of the board member. | | `board_member_id` | string | ✅ | `"3458764569137445003"` | Unique identifier (ID) of the board member whose role you want to update. | *** ### `Miro Update Card Item` Integration name: **MIRO\_UPDATE\_CARD\_ITEM** Tool to update a card item on a Miro board. Use when you need to modify properties of an existing card item such as title, description, due date, assignee, style, position, or geometry. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | -------------------------------------------------------------------------------------------- | | `data` | object | | — | Contains card item data to update, such as the title, description, due date, or assignee ID. | | `style` | object | | — | Contains information about the style of a card item to update, such as the card theme. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `item_id` | string | ✅ | `"3458764654995471486"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Contains geometrical information to update about the item, such as its width or height. | | `position` | object | | — | Contains position information to update for the item on the board. | *** ### `Miro Update Connector` Integration name: **MIRO\_UPDATE\_CONNECTOR** Tool to update an existing connector on a Miro board. Use when you need to modify connector properties such as shape, style, captions, or endpoint attachments. Only provided fields will be updated. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | -------------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------- | | `shape` | string | | `"curved"` | The path type of the connector line, defines curvature. Default: curved. | | `style` | object | | — | Visual styling properties for the connector line and caption. | | `endItem` | object | | — | Defines the starting or ending point of a connector. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board for which you want to update the connector. | | `captions` | array | | — | Blocks of text you want to display on the connector. Maximum 20 captions allowed. | | `startItem` | object | | — | Defines the starting or ending point of a connector. | | `connector_id` | string | ✅ | `"3458764575781967065"` | Unique identifier (ID) of the connector that you want to update. | *** ### `Miro Update Document Item` Integration name: **MIRO\_UPDATE\_DOCUMENT\_ITEM** Tool to update a document item on a Miro board. Use when you need to modify properties of an existing document item such as URL, title, position, or geometry. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------------------------------- | | `data` | object | | — | Data for document URL information. | | `parent` | object | | — | Parent element reference for hierarchical positioning. | | `item_id` | string | ✅ | `"3458764655444616717"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Geometric properties for the document item. You can set either width or height, not both. | | `position` | object | | — | Positioning information for the document item on the board. | *** ### `Miro Update Embed Item` Integration name: **MIRO\_UPDATE\_EMBED\_ITEM** Tool to update an embed item on a board. Use when you need to modify properties of an existing embedded content item such as position, display mode, or URL. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------- | | `data` | object | | — | Data fields for updating the embed item. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `item_id` | string | ✅ | `"3458764654995471216"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Contains geometrical information about the item. You can set either width or height, but not both at the same time. | | `position` | object | | — | Contains information about the item's position on the board. | *** ### `Miro Update Frame Item` Integration name: **MIRO\_UPDATE\_FRAME\_ITEM** Tool to update a frame item on a Miro board. Use when you need to modify properties of an existing frame such as title, position, size, or styling. Include only fields to change. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ----------------------------------------------------------------------- | | `data` | object | | — | Core data for updating a frame item. | | `style` | object | | — | Styling options for updating a frame item. | | `item_id` | string | ✅ | `"3458764655444496605"` | Unique identifier (ID) of the frame that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the frame. | | `geometry` | object | | — | Geometrical dimensions for updating a frame item. | | `position` | object | | — | Board position for updating a frame item. | *** ### `Miro Update Group` Integration name: **MIRO\_UPDATE\_GROUP** Tool to update a group on a Miro board with new items. Use when you need to change which items belong to an existing group. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------ | | `data` | object | ✅ | — | Contains the data with item IDs to be included in the group. | | `board_id` | string | ✅ | `"uXjVOfjmfkE="` | Unique identifier (ID) of the board. | | `group_id` | string | ✅ | `"3858764584681774600"` | Unique identifier (ID) of the group to update. | *** ### `Miro Update Image Item` Integration name: **MIRO\_UPDATE\_IMAGE\_ITEM** Tool to update an existing image item on a board. Use when you need to modify properties of an existing image item such as title, URL, position, or geometry. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------ | | `data` | object | | — | Data fields to update for the image item. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `item_id` | string | ✅ | `"3458764655444615954"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Contains geometrical information about the item. You can set either the width or height, you cannot set both at the same time. | | `position` | object | | — | Contains information about the item's position on the board. | *** ### `Miro Update Item Position Or Parent` Integration name: **MIRO\_UPDATE\_ITEM\_POSITION\_OR\_PARENT** Tool to update an item's position or parent frame on a Miro board. Use when you need to move an item to a new location or assign it to a different parent frame. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------- | | `parent` | object | | — | Parent frame information for updating an item on the board. | | `item_id` | string | ✅ | `"3458764655444496928"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the item. | | `position` | object | | — | Position information for updating an item on the board. | *** ### `Miro Update Shape Item` Integration name: **MIRO\_UPDATE\_SHAPE\_ITEM** Tool to update an existing shape item on a Miro board. Use when you need to modify properties of a shape such as content, style, position, geometry, or parent. Include only the fields you want to change. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------- | | `data` | object | | — | Core data for updating a shape item. | | `style` | object | | — | Styling options for updating a shape item. | | `parent` | object | | — | Parent item reference for updating a shape's nesting. | | `item_id` | string | ✅ | `"3458764655444615983"` | Unique identifier of the shape item to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier of the board containing the shape item. | | `geometry` | object | | — | Geometrical dimensions for updating a shape item. | | `position` | object | | — | Board position for updating a shape item. | *** ### `Miro Update Sticky Note Item` Integration name: **MIRO\_UPDATE\_STICKY\_NOTE\_ITEM** Tool to update a sticky note item on a Miro board. Use when you need to modify the content, style, position, geometry, or parent of an existing sticky note. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `data` | object | | — | Contains sticky note item data, such as the content or shape of the sticky note. | | `style` | object | | — | Contains information about the style of a sticky note item, such as the fill color or text alignment. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `item_id` | string | ✅ | `"3458764655444615971"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Contains geometrical information about the item. You can set either the width or height. You cannot set both the width and height at the same time. | | `position` | object | | — | Contains information about the item's position on the board, such as its x coordinate, y coordinate. | *** ### `Miro Update Tag` Integration name: **MIRO\_UPDATE\_TAG** Tool to update a tag on a board. Use when you need to modify a tag's title or color. At least one field (title or fillColor) should be provided to update. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ----------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------------- | | `title` | string | | `"done"` | Text of the tag. Case-sensitive. Must be unique within the board. | | `tag_id` | string | ✅ | `"3458764654994292201"` | Unique identifier (ID) of the tag that you want to update. | | `board_id` | string | ✅ | `"uXjVJ_fzYUs="` | Unique identifier (ID) of the board where you want to update a specific tag. | | `fillColor` | string | | `"magenta"` | Fill color for the tag. Choose from predefined color options. | *** ### `Miro Update Text Item` Integration name: **MIRO\_UPDATE\_TEXT\_ITEM** Tool to update a text item on a Miro board. Use when you need to modify the content, style, position, or other properties of an existing text item. #### Parameters Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called. | Parameter | Type | Required | Example | Description | | ---------- | ------ | :------: | ----------------------- | ---------------------------------------------------------------------- | | `data` | object | | — | Contains text item data to update. | | `style` | object | | — | Contains information about the style of a text item to update. | | `parent` | object | | — | Contains information about the parent frame for the item. | | `item_id` | string | ✅ | `"3458764655444615965"` | Unique identifier (ID) of the item that you want to update. | | `board_id` | string | ✅ | `"uXjVJDefopU="` | Unique identifier (ID) of the board where you want to update the item. | | `geometry` | object | | — | Contains geometrical information about the item to update. | | `position` | object | | — | Contains information about the item's position on the board to update. | *** --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.toolhouse.ai/toolhouse/integrations/miro.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.