> ## Documentation Index > Fetch the complete documentation index at: https://docs.atako.ai/llms.txt > Use this file to discover all available pages before exploring further. # Miro > Connect Miro to your Atako agents — 6 read and 10 write actions. Let your agents create and manage boards, sticky notes, shapes, text, cards, frames, connectors and tags on your Miro workspace. ## Connection * **Authentication**: OAuth 2.0 — you authorize Atako via Miro's consent screen; no key to copy. * **Scopes requested**: * `boards:read` * `boards:write` Miro → Profile settings (click your avatar) → Your apps → Create app. Set the OAuth Redirect URI to your platform callback URL. Copy the Client ID and Client Secret. Share them with your platform admin so INTEGRATION\_OAUTH\_MIRO\_CLIENT\_ID and INTEGRATION\_OAUTH\_MIRO\_CLIENT\_SECRET are set. The app needs the boards:read and boards:write scopes. See [Miro's documentation](https://developers.miro.com/reference/authorization-flow-for-expiring-tokens). ## Read actions (6) | Action | Description | | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `get_board` | Retrieve information about a specific board by its ID. | | `get_item` | Retrieve a single item (sticky note, shape, card, frame, connector, text, etc.) by its ID. | | `list_board_items` | List items on a board. Optional filters: type (card, connector, frame, shape, sticky\_note, text, app\_card, document, embed, image, mindmap\_node, preview, undefined), limit (1–500), cursor (for pagination), parent\_item\_id (items inside a specific frame or group). | | `list_board_members` | List members of a board. Returns member profiles with role and permissions. | | `list_boards` | List boards accessible to the user. Optional filters: query (search by name), team\_id (boards of a specific team), project\_id, owner (owner ID), limit (1–50, default 20), offset (zero-based), sort (default, last\_modified, last\_opened, last\_created, alphabetically). | | `list_tags` | List all tags on a board. | ## Write actions (10) | Action | Description | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add_tag_to_item` | Attach an existing tag to an item. Pass the tag ID as a query parameter (tag\_id). The tag must already exist on the board (create it first via the Miro UI or another integration). | | `create_board` | Create a new board. name (string, required) is the board name. description (string) is optional. teamId (string) assigns the board to a team. policy (object) controls sharing: policy.permissionPolicy (object with \{type: "private"} or \{type: "team\_add\_only", teamId}) and policy.sharingPolicy (object with \{type: "private"} or \{type: "team\_view\_access", teamId} or \{type: "public", teamLinkAccess: "view"\|"edit", organizationAccess: "view"\|"edit", teamId}). | | `create_card` | Create a card (task card) on a board. data.title (string, required) is the card title. data.description (string) is the card body in plain text or Markdown. data.dueDate (string, ISO 8601 date) sets a due date. data.assigneeId (string) assigns the card to a board member. style.fillColor (string, hex color) sets background color. position.x and position.y (number, pixels relative to board center). parent.id (string) nests inside a frame. | | `create_connector` | Create a connector (line/arrow) between two items. startItem.id (string, required) is the start item ID. endItem.id (string, required) is the end item ID. style (object) sets visual properties: style.strokeColor (string, hex), style.strokeWidth (number), style.endStrokeCap (enum: none\|stealth\|filled\_circle\|open\_circle\|filled\_square\|open\_square\|diamond\|open\_diamond\|x\|bar\|semi\_circle\|slashed\_dash\|slash\_back\|bold\_dash\|empty\_arrow\|orangedot\|bluedot\|orangelogic\|bluelogic\|orangearrow\|bluearrow), style.startStrokeCap (same enum), style.lineType (enum: straight\|elbowed\|curved), style.lineStyle (enum: normal\|dashed\|dotted), style.lineThickness (number). captions (array of strings) adds labels along the connector. | | `create_frame` | Create a frame on a board. data.title (string) is the frame title. data.format (enum: custom\|4:3\|16:9\|3:4\|9:16) sets the aspect ratio. position.x and position.y (number, pixels relative to board center). geometry.width and geometry.height (numbers) set dimensions (required for custom format). | | `create_shape` | Create a shape on a board. data.content (string) is the text inside the shape. data.shape (enum: rectangle\|circle\|triangle\|bar\|cross\|parallelogram\|rhombus\|pentagon\|hexagon\|octagon\|star\|cloud\|pacman\|flowchart\_decision\|flowchart\_process\|flowchart\_predefined\_process\|flowchart\_manual\_input\|flowchart\_manual\_operation\|flowchart\_preparation\|flowchart\_data\|flowchart\_database\|flowchart\_document\|flowchart\_prioritized\_display\|flowchart\_display\|flowchart\_merge\|flowchart\_extract\|flowchart\_or\|flowchart\_stored\_data\|flowchart\_internal\_storage\|flowchart\_off-page\_reference\|flowchart\_chat\_bubble\|flowchart\_line\_callout\|flowchart\_callout\|flowchart\_annotation\_shaped\|flowchart\_tag). style.fillColor (string, hex color) sets background color. position.x and position.y (number, pixels relative to board center). geometry.width and geometry.height (numbers) set dimensions. parent.id (string) nests inside a frame. | | `create_sticky_note` | Create a sticky note on a board. data.content (string) is the note text. data.shape (enum: square\|rectangle) defaults to square. style.fillColor (string, hex color e.g. "#fff9b1") sets the background color. position.x and position.y (number, pixels relative to board center) set the location. geometry.width (number) sets the width. parent.id (string) nests it inside a frame. | | `create_text` | Create a text item on a board. data.content (string) is the text content. position.x and position.y (number, pixels relative to board center). geometry.width (number) sets the text box width. style.fillColor (string, hex color) sets background color. parent.id (string) nests inside a frame. | | `share_board` | Share a board with users by email. emails (array of strings, required) lists the email addresses to invite. role (enum: viewer\|editor\|commenter\|owner, required) sets the permission level. message (string) is an optional invitation message. | | `update_item_position` | Update the position of an item on a board, optionally moving it into or out of a frame. position.x and position.y (number, pixels relative to board center). parent.id (string) nests the item inside a frame; omit parent to move it to the board root. | ## Permissions Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.