Miro

miro

Miro is a collaborative online whiteboard enabling teams to brainstorm ideas, design wireframes, plan workflows, and manage projects visually

Team Collaboration Project Management Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (14)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Create BoardMIRO_CREATE_BOARDAcción

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".

Parámetros de entrada

namestringObligatorio
Name for the board, length between 1 and 60 characters.
policyobject
Defines permissions and sharing policies for the board.
teamIdstring
Unique identifier (ID) of the team where the board will be created.
projectIdstring
Unique identifier (ID) of the project (space) to which the board belongs.
descriptionstring
Description of the board, length between 0 and 300 characters.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete App Card ItemMIRO_DELETE_APP_CARD_ITEMAcción

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.

Parámetros de entrada

item_idstringObligatorio
Unique identifier of the app card item to delete.
board_idstringObligatorio
Unique identifier of the board containing the app card item.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete Document ItemMIRO_DELETE_DOCUMENT_ITEMAcción

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'."

Parámetros de entrada

item_idstringObligatorio
Unique identifier of the document item to delete.
board_idstringObligatorio
Unique identifier of the board containing the document item.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete ItemMIRO_DELETE_ITEMAcción

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.

Parámetros de entrada

item_idstringObligatorio
Unique identifier of the item to delete.
board_idstringObligatorio
Unique identifier of the board containing the item.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get App Card ItemMIRO_GET_APP_CARD_ITEMAcción

Tool to retrieve a specific app card item by its id. use when you need the details of an existing app card item.

Parámetros de entrada

item_idstringObligatorio
Unique identifier of the app card item to retrieve
board_idstringObligatorio
Unique identifier of the board containing the app card item

Parámetros de salida

idstringObligatorio
Unique identifier of the app card item
dataobjectObligatorio
App card data fields
errorstring
Error if any occurred during the execution of the action
linksobjectObligatorio
Relevant resource links
styleobjectObligatorio
Styling info for the app card
parentobject
Parent frame reference for nesting an app card item.
geometryobject
Geometrical dimensions for an app card item.
positionobjectObligatorio
Position info for the app card
createdAtstringObligatorio
ISO timestamp when the card was created
createdByobjectObligatorio
User who created the card
modifiedAtstringObligatorio
ISO timestamp when the card was last modified
modifiedByobjectObligatorio
User who last modified the card
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get BoardMIRO_GET_BOARDAcción

Tool to retrieve details of a specific board. use when you have a board id and need to fetch its metadata.

Parámetros de entrada

board_idstringObligatorio
Unique identifier of the board to retrieve

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Board MembersMIRO_GET_BOARD_MEMBERSAcción

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.

Parámetros de entrada

limitinteger
Number of results per page (max 100).
cursorstring
Cursor for pagination, used to retrieve subsequent pages.
board_idstringObligatorio
Unique identifier of the board.

Parámetros de salida

dataobject[]Obligatorio
List of board members.
sizeintegerObligatorio
Number of members returned in this response.
typestring
Type of the response (e.g., 'list').
errorstring
Error if any occurred during the execution of the action
limitinteger
Number of members returned per page.
linksobject
Links related to the members list.
totalintegerObligatorio
Total number of members on the board.
cursorstring
Cursor to retrieve the next page of results, if any.
offsetinteger
Offset of the returned members.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get BoardsMIRO_GET_BOARDSAcción

Tool to retrieve accessible boards with optional filters. use when you need to list or search boards by team, project, owner, or keywords.

Parámetros de entrada

sortstringenum
Sort order of the results.
defaultlast_createdlast_openedlast_modifiedalphabetically
limitinteger
Number of boards to return per page.
ownerstring
Filter boards by owner user ID.
querystring
Search query to filter boards by name.
offsetinteger
Offset for pagination.
team_idstring
Filter boards by team ID.
project_idstring
Filter boards by project (space) ID.

Parámetros de salida

dataobject[]Obligatorio
List of boards.
errorstring
Error if any occurred during the execution of the action
limitintegerObligatorio
Number of boards returned per page.
totalintegerObligatorio
Total number of boards accessible.
offsetintegerObligatorio
Offset of the returned boards.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get ConnectorsMIRO_GET_CONNECTORSAcción

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.

Parámetros de entrada

limitinteger
Maximum number of results to return per call (10 to 50). Defaults to 10.
cursorstring
Cursor for pagination to retrieve the next page of connectors.
board_idstringObligatorio
Unique identifier of the board to retrieve connectors from.

Parámetros de salida

dataobject[]Obligatorio
List of connectors returned.
sizeintegerObligatorio
Number of results in this response page.
errorstring
Error if any occurred during the execution of the action
limitintegerObligatorio
Maximum number of results returned per call.
linksobjectObligatorio
Pagination links for the collection.
totalintegerObligatorio
Total number of connectors in the collection.
cursorstring
Cursor value to retrieve the next page of results, if any.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get TagMIRO_GET_TAGAcción

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.

Parámetros de entrada

tag_idstringObligatorio
Unique identifier of the tag to retrieve.
board_idstringObligatorio
Unique identifier of the board where the tag resides.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List OrganizationsMIRO_LIST_ORGANIZATIONSAcción

Tool to retrieve list of organizations accessible to the user. use when you need to view all available organizations.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobject[]Obligatorio
List of organizations
errorstring
Error if any occurred during the execution of the action
pagingobject
Pagination information for listing organizations.
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create App Card ItemMIRO_MIRO_CREATE_APP_CARD_ITEMAcción

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 (e.g., after assembling card data).

Parámetros de entrada

dataobjectObligatorio
Payload data for the app card
styleobject
Styling options for an app card item.
parentobject
Parent frame reference for nesting an app card item.
board_idstringObligatorio
ID of the board to add the app card to
geometryobject
Geometrical dimensions for an app card item.
positionobject
Board position for an app card item.

Parámetros de salida

idstringObligatorio
Unique identifier of the new app card item
dataobjectObligatorio
Echoed app card data
errorstring
Error if any occurred during the execution of the action
linksobjectObligatorio
Relevant resource links
styleobjectObligatorio
Echoed style info
parentobject
Parent frame reference for nesting an app card item.
geometryobject
Geometrical dimensions for an app card item.
positionobjectObligatorio
Echoed position info
createdAtstringObligatorio
ISO timestamp when item was created
createdByobjectObligatorio
User who created the item
modifiedAtstringObligatorio
ISO timestamp when item was last modified
modifiedByobjectObligatorio
User who last modified the item
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update App Card ItemMIRO_UPDATE_APP_CARD_ITEMAcción

Tool to update an app card item on a board. use when you need to modify properties of an existing app card item. include only fields to change.

Parámetros de entrada

dataobject
Core data for an app card item.
styleobject
Styling options for an app card item.
parentobject
Parent frame reference for nesting an app card item.
item_idstringObligatorio
ID of the app card item to update
board_idstringObligatorio
ID of the board containing the app card item
geometryobject
Geometrical dimensions for an app card item.
positionobject
Board position for an app card item.

Parámetros de salida

idstringObligatorio
Unique identifier of the app card item
dataobjectObligatorio
App card data after update
errorstring
Error if any occurred during the execution of the action
linksobjectObligatorio
Links related to the app card item
styleobjectObligatorio
Styling info after update
parentobject
Parent frame reference for nesting an app card item.
geometryobject
Geometrical dimensions for an app card item.
positionobjectObligatorio
Position info after update
createdAtstringObligatorio
ISO timestamp when the app card item was created
createdByobjectObligatorio
User who created the app card item
modifiedAtstringObligatorio
ISO timestamp when the app card item was last modified
modifiedByobjectObligatorio
User who last modified the app card item
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update BoardMIRO_UPDATE_BOARDAcción

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.

Parámetros de entrada

namestring
New name for the board (1-60 characters)
policyobject
Defines permissions and sharing policies for the board
teamIdstring
ID of the team where the board should be placed
board_idstringObligatorio
Unique identifier (ID) of the board to update
projectIdstring
ID of the project (space) to which the board should be added
descriptionstring
New description for the board (up to 300 characters)

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not