# Miro

Manage Miro boards: items (shapes, sticky notes, cards, frames), members, tags. Exposes **24 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `miro_get_me` | Get authenticated user info - GET /me. |
| `miro_list_boards` | List all boards - GET /boards. |
| `miro_get_board` | Get one board - GET /boards/{board_id}. |
| `miro_create_board` | Create a new board - POST /boards. |
| `miro_update_board` | Update a board - PATCH /boards/{board_id}. |
| `miro_delete_board` | Delete a board - DELETE /boards/{board_id}. |
| `miro_list_items` | List items on a board - GET /boards/{board_id}/items. |
| `miro_get_item` | Get one item - GET /boards/{board_id}/items/{item_id}. |
| `miro_create_item` | Create an item on a board - POST /boards/{board_id}/items. |
| `miro_update_item` | Update an item - PATCH /boards/{board_id}/items/{item_id}. |
| `miro_delete_item` | Delete an item - DELETE /boards/{board_id}/items/{item_id}. |
| `miro_list_board_members` | List board members - GET /boards/{board_id}/members. |
| `miro_get_board_member` | Get one board member - GET /boards/{board_id}/members/{member_id}. |
| `miro_add_board_member` | Add a member to a board - POST /boards/{board_id}/members. |
| `miro_update_board_member` | Update a board member role - PATCH /boards/{board_id}/members/{member_id}. |
| `miro_remove_board_member` | Remove a member from a board - DELETE /boards/{board_id}/members/{member_id}. |
| `miro_list_tags` | List tags on a board - GET /boards/{board_id}/tags. |
| `miro_create_tag` | Create a tag on a board - POST /boards/{board_id}/tags. |
| `miro_update_tag` | Update a tag - PATCH /boards/{board_id}/tags/{tag_id}. |
| `miro_delete_tag` | Delete a tag - DELETE /boards/{board_id}/tags/{tag_id}. |
| `miro_list_groups` | List groups on a board - GET /boards/{board_id}/groups. |
| `miro_create_group` | Create a group - POST /boards/{board_id}/groups. |
| `miro_update_group` | Update a group - PATCH /boards/{board_id}/groups/{group_id}. |
| `miro_delete_group` | Delete a group - DELETE /boards/{board_id}/groups/{group_id}. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Miro to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Miro API documentation](https://developers.miro.com/reference)