Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually
Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually On Nagent, Miro is exposed as a fully-configurable team collaboration integration that any agent can call — 77 actions, and OAuth authentication. No code is required to wire Miro into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Miro to automate the kinds of tasks team collaboration teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Miro into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Miro, with input parameters and output schema. Drop these into any step of an agent built in Helix.
MIRO_ATTACH_TAG_TO_ITEMTool 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.
Input parameters
Unique identifier of the tag to attach to the item.
Unique identifier of the item to attach the tag to. Card and sticky note items can have up to 8 tags.
Unique identifier of the board containing the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_APP_CARD_ITEMTool 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.
Input parameters
Payload data for the app card
Styling options for an app card item.
Parent frame reference for nesting an app card item.
ID of the board to add the app card to
Geometrical dimensions for an app card item.
Board position for an app card item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_BOARDTool 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.
Input parameters
Name for the board, length between 1 and 60 characters.
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`.
Unique identifier (ID) of the team where the board will be created.
Unique identifier (ID) of the project (space) to which the board belongs.
Description of the board, length between 0 and 300 characters.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_CARD_ITEMTool to create a card item on a Miro board. Use when you need to add task cards with titles, descriptions, due dates, and assignees.
Input parameters
Core data for a card item.
Styling options for a card item.
Parent item reference for nesting a card.
Unique identifier of the board where the card will be created
Geometrical dimensions for a card item.
Board position for a card item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_CONNECTORTool 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.
Input parameters
Shape/style of the connector line.
Visual styling properties for the connector line and caption.
Defines the ending point of the connector. Must specify either snapTo or position.
Unique identifier of the board where the connector will be created.
Array of caption objects to display text along the connector.
Defines the starting point of the connector. Must specify either snapTo or position.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_DOCUMENT_ITEMTool 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.
Input parameters
Contains the document URL and optional title.
Parent element reference for hierarchical positioning.
The unique identifier of the board where the document will be created.
Geometric properties with fixed aspect ratio for the document item.
Positioning information for the document item on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_DOCUMENT_ITEM_USING_FILE_FROM_DEVICETool 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.
Input parameters
Data containing document metadata like title.
Parent frame information for the item.
Unique identifier (ID) of the board where you want to create the item.
Geometrical information about the item.
Position information for the document item on the board.
Document file to upload. Maximum file size: 6 MB. Supported format: PDF.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_EMBED_ITEMTool 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.
Input parameters
Contains information about the embed URL.
Parent element reference for hierarchical positioning.
Unique identifier (ID) of the board where you want to create the item.
Geometrical information about the embed item.
Positioning information for the embed item on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_FRAME_ITEMTool to add a frame item to a Miro board. Use frames to group and organize diagram regions (e.g., swimlanes, sections, slides).
Input parameters
Contains frame-specific properties like title and format. This field is required.
Styling options for a frame item.
Parent item reference for nesting a frame.
Unique identifier of the board where the frame will be added
Geometrical dimensions for a frame item.
Board position for a frame item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_FRAME_ITEM2DEPRECATED: 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.
Input parameters
Contains frame item data, such as the title, frame type, or frame format.
Styling options for a frame item.
Unique identifier (ID) of the board where you want to create a frame.
Geometrical dimensions for a frame item.
Board position for a frame item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_GROUPTool 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.
Input parameters
Contains the data with item IDs to be grouped.
Unique identifier (ID) of the board where the group will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_IMAGE_ITEM_USING_LOCAL_FILETool 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.
Input parameters
Core data for an image item.
Parent item reference for nesting an image.
Unique identifier (ID) of the board where you want to create the image item.
Geometrical dimensions for an image item.
Board position for an image item.
Image file to upload. Supported formats: PNG, JPG, JPEG, GIF, SVG, etc.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_ITEMS_IN_BULKTool 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.
Input parameters
List of items to create. You can create 1 to 20 items per request.
Unique identifier of the board where items will be created.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_MINDMAP_NODE_EXPERIMENTALTool 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.
Input parameters
Core mind map node data including the node view with content.
Unique identifier (ID) of the board where you want to create the mind map node.
Geometry for the mind map node.
Position for the mind map node on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_SHAPE_ITEMDEPRECATED: 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.
Input parameters
Core shape data including content text and shape type.
Styling options for a shape item.
Parent item reference for nesting a shape.
Unique identifier of the board where the shape will be created.
Geometrical dimensions for a shape item.
Board position for a shape item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_SHAPE_ITEM2Tool 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.
Input parameters
Core data for a shape item.
Styling options for a shape item.
Parent frame information for the shape item.
Unique identifier (ID) of the board where you want to create the item.
Geometrical information about the shape item.
Position information for the shape item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_STICKY_NOTE_ITEMTool 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.
Input parameters
Contains sticky note item data, such as the content or shape of the sticky note.
Contains information about the style of a sticky note item, such as the fill color or text alignment.
Contains information about the parent frame for the item.
Unique identifier (ID) of the board where you want to create the item.
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.
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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_TAGTool 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.
Input parameters
Text of the tag. Case-sensitive. Must be unique within the board.
Unique identifier (ID) of the board where you want to create the tag.
Fill color for the tag. Choose from predefined color options. Defaults to 'red' if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_CREATE_TEXT_ITEMTool 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.
Input parameters
Contains text item data, such as the content.
Styling options for a text item.
Parent item reference for nesting a text item.
Unique identifier (ID) of the board where you want to create the item.
Geometrical dimensions for a text item.
Board position for a text item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_APP_CARD_ITEMTool 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.
Input parameters
Unique identifier of the app card item to delete.
Unique identifier of the board containing the app card item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_CARD_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_CONNECTORTool 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.
Input parameters
Unique identifier (ID) of the board from which you want to delete the connector.
Unique identifier (ID) of the connector that you want to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_DOCUMENT_ITEMTool 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'."
Input parameters
Unique identifier of the document item to delete.
Unique identifier of the board containing the document item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_EMBED_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_FRAME_ITEMTool 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.
Input parameters
Unique identifier (ID) of the frame that you want to delete.
Unique identifier (ID) of the board from which you want to delete the frame.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_GROUPTool to delete a group from a board. Use when you need to remove a group and optionally its items.
Input parameters
Unique identifier (ID) of the board.
Unique identifier (ID) of the group.
Indicates whether the items should be removed. Set to `true` to delete items in the group.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_IMAGE_ITEMTool to delete an image item from a board. Use when you need to remove an image that is no longer needed.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_ITEMTool 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.
Input parameters
Unique identifier of the item to delete.
Unique identifier of the board containing the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_MINDMAP_NODE_EXPERIMENTALTool 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.
Input parameters
Unique identifier (ID) of the mind map node that you want to delete.
Unique identifier (ID) of the board from which you want to delete the mind map node.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_SHAPE_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_STICKY_NOTE_ITEMTool to delete a sticky note item from a board. Use when you need to remove a sticky note that is no longer needed.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_TAGTool to delete a specific tag from a board. Use when you need to remove a tag after confirming its board and tag IDs.
Input parameters
Unique identifier (ID) of the tag that you want to delete.
Unique identifier (ID) of the board where you want to delete a specific tag.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_DELETE_TEXT_ITEMTool to delete a text item from a board. Use when you need to remove a text item after confirming its board and item IDs.
Input parameters
Unique identifier (ID) of the item that you want to delete.
Unique identifier (ID) of the board from which you want to delete the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_ALL_GROUPSTool 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.
Input parameters
The maximum number of groups to return at one time. Default is 10, minimum is 10, maximum is 50.
Cursor for pagination. Use the cursor value from a previous response to retrieve the next page of results.
Unique identifier (ID) of the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_APP_CARD_ITEM2Tool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_BOARDDEPRECATED: 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.
Input parameters
Unique identifier of the board to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_BOARD_ITEMSTool 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.
Input parameters
Filter by item type. Note: 'connector' is not supported; use the separate Get Connectors action instead.
Maximum number of items to return per page (10-50)
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).
Unique identifier of the board to retrieve items from
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_BOARD_MEMBERSTool 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.
Input parameters
Number of results per page (max 100).
Cursor for pagination, used to retrieve subsequent pages.
Unique identifier of the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_BOARDSDEPRECATED: 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.
Input parameters
Sort order of the results.
Number of boards to return per page (1-50). Values above 50 cause a 400 error.
Filter boards by owner user ID.
Search query to filter boards by name.
Offset for pagination. Increment by `limit` value until results are exhausted to retrieve all pages.
Filter boards by team ID.
Filter boards by project (space) ID.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_BOARDS2Tool 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.
Input parameters
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`).
Maximum number of boards to retrieve (1-50). Default: 20
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.
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.
Zero-based offset of the first item in the collection. Default: 0
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.
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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_CARD_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_CONNECTORTool to retrieve a specific connector by its ID. Use when you need details about an existing connector on a board.
Input parameters
Unique identifier (ID) of the board from which you want to retrieve a specific connector.
Unique identifier (ID) of the connector that you want to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_CONNECTORSTool to retrieve a list of connectors on a board. Use after confirming the board ID and when you need to page through connector items.
Input parameters
Maximum number of results to return per call (10 to 50). Defaults to 10.
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.
Unique identifier of the board to retrieve connectors from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_DOCUMENT_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_EMBED_ITEMTool to retrieve a specific embed item from a board by its ID. Use when you need details of an existing embedded content item.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_FRAME_ITEMTool to retrieve a specific frame item from a Miro board. Use when you need to fetch details of an existing frame by its ID.
Input parameters
Unique identifier (ID) of the frame that you want to retrieve.
Unique identifier (ID) of the board that contains the frame that you want to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_GROUP_BY_IDTool to retrieve a specific group by its ID. Use when you need to get details about a group on a Miro board.
Input parameters
Unique identifier (ID) of the board.
Unique identifier (ID) of the group.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_IMAGE_ITEMTool to retrieve a specific image item from a board. Use when you need to get details about an existing image item.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_ITEM_TAGSTool 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.
Input parameters
Unique identifier of the item to retrieve tags from.
Unique identifier of the board containing the item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_MINDMAP_NODE_EXPERIMENTALTool 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.
Input parameters
Unique identifier (ID) of the mind map node that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a mind map node.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_MINDMAP_NODES_EXPERIMENTALTool 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.
Input parameters
Maximum number of results returned.
Points to the next portion of the results set. Use the cursor value from a previous response to retrieve the next page.
Unique identifier (ID) of the board from which you want to retrieve mind map nodes.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_OEMBEDTool 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.
Input parameters
The URL pointing to the Miro board resource to return as oEmbed data. Must be a valid Miro board URL (e.g., https://miro.com/app/board/uXjVJ_fzYUs=).
Specifies the return format of the response. Only 'json' is supported. Defaults to 'json' if not specified.
The maximum width available to the embed, in pixels. The oEmbed response will respect this constraint.
The URL pointing to the source of the request. Used to track where the embed will be displayed.
The maximum height available to the embed, in pixels. The oEmbed response will respect this constraint.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_SHAPE_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_SPECIFIC_BOARDTool 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.
Input parameters
Unique identifier (ID) of the board that you want to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_SPECIFIC_BOARD_MEMBERTool 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.
Input parameters
Unique identifier (ID) of the board to which the board member belongs.
Unique identifier (ID) of the board member whose role you want to retrieve.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_SPECIFIC_ITEMTool 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.).
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_STICKY_NOTE_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_TAGTool to retrieve details of a specific tag on a board. Use when you have a board ID and tag ID and need its metadata.
Input parameters
Unique identifier of the tag to retrieve.
Unique identifier of the board where the tag resides.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_GET_TEXT_ITEMTool 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.
Input parameters
Unique identifier (ID) of the item that you want to retrieve.
Unique identifier (ID) of the board from which you want to retrieve a specific item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_LIST_BOARD_TAGSTool to list all tags on a Miro board. Use when you need to discover tag IDs, titles, or colors before performing tag operations.
Input parameters
Maximum number of tags to return per page (min 1).
Cursor for paginating results; use the value from a prior response.
Unique identifier of the board to retrieve tags from.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_LIST_ORGANIZATIONSRetrieves 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.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_SHARE_BOARDTool 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).
Input parameters
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'.
Email addresses of the users you want to invite to the board. You can invite up to 20 members per call.
Optional message that will be sent in the invitation email to the invited users.
Unique identifier (ID) of the board to which you want to invite members.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_APP_CARD_ITEM2Tool 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.
Input parameters
Core data for an app card item.
Styling information for an app card item.
Parent frame information for an app card item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Geometrical information about an app card item.
Position information for an app card item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_BOARDTool 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.
Input parameters
New name for the board (1-60 characters)
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.
ID of the team where the board should be placed
Unique identifier (ID) of the board to update
ID of the project (space) to which the board should be added
New description for the board (up to 300 characters)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_BOARD_MEMBERTool 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.
Input parameters
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).
Unique identifier (ID) of the board for which you want to update the role of the board member.
Unique identifier (ID) of the board member whose role you want to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_CARD_ITEMTool 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.
Input parameters
Contains card item data to update, such as the title, description, due date, or assignee ID.
Contains information about the style of a card item to update, such as the card theme.
Contains information about the parent frame for the item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Contains geometrical information to update about the item, such as its width or height.
Contains position information to update for the item on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_CONNECTORTool 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.
Input parameters
The path type of the connector line, defines curvature. Default: curved.
Visual styling properties for the connector line and caption.
Defines the starting or ending point of a connector.
Unique identifier (ID) of the board for which you want to update the connector.
Blocks of text you want to display on the connector. Maximum 20 captions allowed.
Defines the starting or ending point of a connector.
Unique identifier (ID) of the connector that you want to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_DOCUMENT_ITEMTool 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.
Input parameters
Data for document URL information.
Parent element reference for hierarchical positioning.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Geometric properties for the document item. You can set either width or height, not both.
Positioning information for the document item on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_EMBED_ITEMTool 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.
Input parameters
Data fields for updating the embed item.
Contains information about the parent frame for the item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Contains geometrical information about the item. You can set either width or height, but not both at the same time.
Contains information about the item's position on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_FRAME_ITEMTool 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.
Input parameters
Core data for updating a frame item.
Styling options for updating a frame item.
Unique identifier (ID) of the frame that you want to update.
Unique identifier (ID) of the board where you want to update the frame.
Geometrical dimensions for updating a frame item.
Board position for updating a frame item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_GROUPTool to update a group on a Miro board with new items. Use when you need to change which items belong to an existing group.
Input parameters
Contains the data with item IDs to be included in the group.
Unique identifier (ID) of the board.
Unique identifier (ID) of the group to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_IMAGE_ITEMTool 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.
Input parameters
Data fields to update for the image item.
Contains information about the parent frame for the item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Contains geometrical information about the item. You can set either the width or height, you cannot set both at the same time.
Contains information about the item's position on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_ITEM_POSITION_OR_PARENTTool 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.
Input parameters
Parent frame information for updating an item on the board.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Position information for updating an item on the board.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_SHAPE_ITEMTool 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.
Input parameters
Core data for updating a shape item.
Styling options for updating a shape item.
Parent item reference for updating a shape's nesting.
Unique identifier of the shape item to update.
Unique identifier of the board containing the shape item.
Geometrical dimensions for updating a shape item.
Board position for updating a shape item.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_STICKY_NOTE_ITEMTool 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.
Input parameters
Contains sticky note item data, such as the content or shape of the sticky note.
Contains information about the style of a sticky note item, such as the fill color or text alignment.
Contains information about the parent frame for the item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
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.
Contains information about the item's position on the board, such as its x coordinate, y coordinate.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_TAGTool 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.
Input parameters
Text of the tag. Case-sensitive. Must be unique within the board.
Unique identifier (ID) of the tag that you want to update.
Unique identifier (ID) of the board where you want to update a specific tag.
Fill color for the tag. Choose from predefined color options.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MIRO_UPDATE_TEXT_ITEMTool 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.
Input parameters
Contains text item data to update.
Contains information about the style of a text item to update.
Contains information about the parent frame for the item.
Unique identifier (ID) of the item that you want to update.
Unique identifier (ID) of the board where you want to update the item.
Contains geometrical information about the item to update.
Contains information about the item's position on the board to update.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 59 agents privately built on Nagent that already use Miro.
Build on Nagent
Connect Miro to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Miro, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Miro is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Miro is connected, you configure its 77 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Miro steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Miro event fires, the agent kicks off automatically.
Every Miro action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Miro ships with 77 pre-built team collaboration actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Miro together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Miro-based workflows tailored to your business.