miro

name

miro

description

Miro is an online collaborative whiteboarding platform that provides visual workspaces, templates, and integrations for brainstorming, planning, diagramming, and workshops, allowing teams and developers to coordinate ideas, map processes, and embed collaboration into broader workflows. Read and write Miro data through One: boards, shapes, teams, groups, boarditems, users and more, 197 actions with real parameter documentation. Use whenever the user asks to look something up in Miro, create or update a record there, or build code against the Miro API.

Miro through One

Miro is an online collaborative whiteboarding platform that provides visual workspaces, templates, and integrations for brainstorming, planning, diagramming, and workshops, allowing teams and developers to coordinate ideas, map processes, and embed collaboration into broader workflows.

One exposes Miro through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform miro if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Miro is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Miro account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Boards

Action	Method	Path	Action id
Get a Specific Board	GET	/v2/boards/{{boardId}}	conn_mod_def::GLXcMp32nkA::aVXBV1kRTcqi_0YumJvWDw
Get Boards	GET	/v2/boards	conn_mod_def::GLXcMqx-RLg::riGxn_8IQ0y_1FUXcQtMEw
Copy Board	PUT	/v2/boards	conn_mod_def::GLXcMf7X0OA::QK5NBemxRGKW6EqR4Bv6Eg
Create a Board Frame	POST	/v2/boards/{{boardId}}/frames	conn_mod_def::GLXcN-v4-nA::aLOWprnwRQeIDszFgsXIlg
Create Board	POST	/v2/boards	conn_mod_def::GLXcMe0qLmA::Q8i8w3zLSiGl7casMWHaaQ
Create Items in Bulk for a Board	POST	/v2/boards/{{boardId}}/items/bulk	conn_mod_def::GLXcMrj2nug::47Soa_Q-TUmJrOYgmo3Q5Q
Delete a Board	DELETE	/v2/boards/{{boardId}}	conn_mod_def::GLXcMeVel0g::WdiyyphvTXSb-OAwiGEZFQ
Delete an Item from a Board	DELETE	/v2/boards/{{boardId}}/items/{{itemId}}	conn_mod_def::GLXcOu7QOqg::Aq9kGvMbT9ucOsFFTIVQXQ
Delete an Item from a Board	DELETE	/v2-experimental/boards/{{boardId}}/items/{{itemId}}	conn_mod_def::GLXcO7Zx8Sg::VkMv0qnvSWGb_1Iu3FZXGg
Update a Board	PATCH	/v2/boards/{{boardId}}	conn_mod_def::GLXcMp1NfWA::SJLfEHCyRvGdV6bXYN3vNg
Update a Board Frame	PATCH	/v2/boards/{{boardId}}/frames/{{itemId}}	conn_mod_def::GLXcOMy5YsA::SuSZaWw2QOmTYQ8mHMiZgQ

Shapes

Action	Method	Path	Action id
Get a Shape Item on a Board	GET	/v2/boards/{{boardId}}/shapes/{{itemId}}	conn_mod_def::GLXcQQuQejA::ZaYH6W32RpqB4e80C_wsHg
Get a Shape Item on a Board	GET	/v2-experimental/boards/{{boardId}}/shapes/{{itemId}}	conn_mod_def::GLXcOAL44yA::Wwzs5kADSUa1imZyLKsoKg
Create a Shape Item on a Board	POST	/v2/boards/{{boardId}}/shapes	conn_mod_def::GLXcQHsC5IA::oPi4kc1KT5CEPP48BaWV8Q
Create Shapes Using Boards	POST	/v2-experimental/boards/{{boardId}}/shapes	conn_mod_def::GLXcNy92KKA::shFBJuDOQIqpUjPK9pKsIA
Delete a Shape Item from a Board	DELETE	/v2/boards/{{boardId}}/shapes/{{itemId}}	conn_mod_def::GLXcQIYmAzg::sJBbEcPxRmaYJoltXKkhOA
Delete a Shape Item from a Board	DELETE	/v2-experimental/boards/{{boardId}}/shapes/{{itemId}}	conn_mod_def::GLXcN2xdGeA::dUVNqVR7TqW7D98c3PBTBg
Update a Shape Item on a Board	PATCH	/v2/boards/{{boardId}}/shapes/{{itemId}}	conn_mod_def::GLXcQdWgVjg::OedFdfjIQwanuuGVR4eSQQ

Teams

Action	Method	Path	Action id
Get a Team in an Organization	GET	/v2/orgs/{{orgId}}/teams/{{teamId}}	conn_mod_def::GLXcSquMfcg::lJxOEb62T9ySOc8cH-eooQ
Get Teams for a User Group	GET	/v2/orgs/{{orgId}}/groups/{{groupId}}/teams	conn_mod_def::GLXcTV7aTqg::WdVWNLU_Tl67ZbnV89OFiA
List Teams in an Organization	GET	/v2/orgs/{{orgId}}/teams	conn_mod_def::GLXcSrCWFoA::8-y4FwtQQYiv-2GSO3yPMg
Bulk Update Boards Classification for a Team in an Organization	PATCH	/v2/orgs/{{orgId}}/teams/{{teamId}}/data-classification	conn_mod_def::GLXcMDa9tzg::fGRaJHYISp6tMTNjQOiiZA
Create a Team in an Organization	POST	/v2/orgs/{{orgId}}/teams	conn_mod_def::GLXcSf_jl0A::nii6xizVQfmhQa319NpVFg
Delete a Team in an Organization	DELETE	/v2/orgs/{{orgId}}/teams/{{teamId}}	conn_mod_def::GLXcSgWGWug::G7Is7iA-TTG2PQPFW-mZYA
Update a Team in an Organization	PATCH	/v2/orgs/{{orgId}}/teams/{{teamId}}	conn_mod_def::GLXcSqcUbuA::MJHM7fszT-OcmwY6Af_ysA

Groups

Action	Method	Path	Action id
Get a Group	GET	/Groups/{{id}}	conn_mod_def::GLXcONUvyGg::C9IyhpmPTsChdE0JGWQy0w
Get All Groups on a Board	GET	/v2/boards/{{boardId}}/groups	conn_mod_def::GLXcOdTLNSg::s6jPZPQCRr-4rSd1PtIvCQ
List Groups	GET	/Groups	conn_mod_def::GLXcOLOIdPg::g_SHL0A4Sqa2CAVJQd9LsQ
Create Group on a Board	POST	/v2/boards/{{boardId}}/groups	conn_mod_def::GLXcOYzi4eg::CYTL2NWySyy_cgBRGK0rAg
Delete a Group from a Board	DELETE	/v2/boards/{{boardId}}/groups/{{groupId}}	conn_mod_def::GLXcOUjwv3g::LDU3weQiR2GZMcIC6ZWy3w
Patch a Group	PATCH	/Groups/{{id}}	conn_mod_def::GLXcOYzvWVA::frqzOUlXRsa4iFZKSSRX4A
Ungroup Items from a Board Group	DELETE	/v2/boards/{{boardId}}/groups/{{groupId}}	conn_mod_def::GLXcOl88YpA::2-OvCP_rSYeRUo2DgKrBLg

BoardItems

Action	Method	Path	Action id
Get a Specific Board Item	GET	/v2-experimental/boards/{{boardId}}/items/{{itemId}}	conn_mod_def::GLXcN-UglSg::o1ZvtJchSGWeH8GcFNwIGQ
Get a Specific Board Item	GET	/v2/boards/{{boardId}}/items/{{itemId}}	conn_mod_def::GLXcO5VZwkA::Kd8CAqWqSxKTnMyMaTQm3A
Get Board Items	GET	/v2-experimental/boards/{{boardId}}/items	conn_mod_def::GLXcN_V_h_g::XhdXj12FS_mvGRe2utDm1w
Get Board Items	GET	/v2/boards/{{boardId}}/items	conn_mod_def::GLXcO69cY6A::X3edrEcBRiqoTG_iosPc7Q
Attach Tag to an Item on a Board	POST	/v2/boards/{{boardIdPlatformTags}}/items/{{itemId}}	conn_mod_def::GLXcQ9R-jFA::Q7VUs2RRT2K1I0c2IDHmGQ
Remove Tag from an Item on a Board	DELETE	/v2/boards/{{boardIdPlatformTags}}/items/{{itemId}}	conn_mod_def::GLXcRF2O-Qg::5jeeqbIoR5yHb1zfcuSICQ

Users

Action	Method	Path	Action id
Get a User	GET	/Users/{{id}}	conn_mod_def::GLXcTDqfryA::OD7ZvyBeSZyFFyaP4zqV4Q
List Users	GET	/Users	conn_mod_def::GLXcTDrqKYg::Dv1hWGGbS22BU-i48FglJQ
Create User	POST	/Users	conn_mod_def::GLXcS5lpkrA::N0q7L6ygSkyGS8zBRlWG7w
Delete User	DELETE	/Users/{{id}}	conn_mod_def::GLXcTBlWG7A::vfxECqs4RCqKOIqtCqJXWw
Patch a User	PATCH	/Users/{{id}}	conn_mod_def::GLXcTD4yV3g::70osCGt1T2KmKzO-1jZXdg
Replace a User	PUT	/Users/{{id}}	conn_mod_def::GLXcTDFgtdA::6W2os33ZSA-klPxGoEp9cw

Images

Action	Method	Path	Action id
Get an Image Item on a Board	GET	/v2/boards/{{boardId}}/images/{{itemId}}	conn_mod_def::GLXcOyBwXHg::1LK9RA6eRbSBV92u6Rb2MA
Create an Image Item Using URL for a Board	POST	/v2/boards/{{boardId}}/images	conn_mod_def::GLXcOmCdLvg::Gk5Ho-d6QcCNPw9tLy6Q6g
Create Image Item Using File from Device for a Board	POST	/v2/boards/{{boardIdPlatformFileUpload}}/images	conn_mod_def::GLXcOyBPjgg::OOnHcQymQKG-eitjEWMZbw
Delete an Image Item from a Board	DELETE	/v2/boards/{{boardId}}/images/{{itemId}}	conn_mod_def::GLXcOlpsxZg::HlkgTckXQCeXKOzSCzw-qQ
Update an Image Item Using File From Device	PATCH	/v2/boards/{{boardIdPlatformFileUpload}}/images/{{itemId}}	conn_mod_def::GLXcOwWwXog::hX-yaLQRTNSKB13W1NzpFQ
Update an Image Item Using URL on a Board	PATCH	/v2/boards/{{boardId}}/images/{{itemId}}	conn_mod_def::GLXcOxy7DQg::hcAxY2P1RnuOKIX5IC8SBA

ProjectMembers

Action	Method	Path	Action id
Get a Project Member	GET	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}/members/{{memberId}}	conn_mod_def::GLXcP1dSXIg::3bLpOzNGRxaJhvKE0KSpBg
List Project Members for an Organization Team Project	GET	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}/members	conn_mod_def::GLXcP29OKZg::QHXh0KVCQoeix874Yv9CSA
Add Member to a Project	POST	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}/members	conn_mod_def::GLXcP28_e8g::TCzJSMW-T4GKTqKMkqjFbg
Remove a Project Member	DELETE	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}/members/{{memberId}}	conn_mod_def::GLXcP16AwXA::7TTiThwSQwKC6HicRsnXeg
Update a Project Member	PATCH	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}/members/{{memberId}}	conn_mod_def::GLXcP1t7Hqg::cTlVAjXLRZqz10uMtvjJJg

Projects

Action	Method	Path	Action id
Get Project for a Team in an Organization	GET	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}	conn_mod_def::GLXcP-qK7fg::hmifFgGVSwKTERbp7THgkQ
List Projects in an Organization Team	GET	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects	conn_mod_def::GLXcQIYzwsA::6hk1aTBXQtm8lP31B2pxfg
Create a Team Project in an Organization	POST	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects	conn_mod_def::GLXcP_p8NpA::8d_MK8kQT7-NH6-9Hs0H3w
Delete a Team Project in an Organization	DELETE	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}	conn_mod_def::GLXcP-p7nBg::wRnCgiLuQ_S0gItIbIIy2Q
Update a Team Project in an Organization	PATCH	/v2/orgs/{{orgId}}/teams/{{teamId}}/projects/{{projectId}}	conn_mod_def::GLXcQH6sg8A::VGEJDsaEQIOH8L41hqhjIA

UserGroups

Action	Method	Path	Action id
Get a User Group in an Organization	GET	/v2/orgs/{{orgId}}/groups/{{groupId}}	conn_mod_def::GLXcTVxet7g::uL_trn_DS7WdcBnmrllI8Q
List User Groups for an Organization	GET	/v2/orgs/{{orgId}}/groups	conn_mod_def::GLXcTlGoqbg::ccl2HFB7TmaX0tsT73MfEw
Create a User Group in an Organization	POST	/v2/orgs/{{orgId}}/groups	conn_mod_def::GLXcTVIC_-A::tJAdJJBJQmCNHXblsuVXzA
Delete a User Group in an Organization	DELETE	/v2/orgs/{{orgId}}/groups/{{groupId}}	conn_mod_def::GLXcTUjK1MA::X1UyQrh-SZOkm5F9SKzjbg
Update a User Group in an Organization	PATCH	/v2/orgs/{{orgId}}/groups/{{groupId}}	conn_mod_def::GLXcTj1B2qg::TTzyP1G6Rf6GiMcywJ-BHg

BoardExportJobs

Action	Method	Path	Action id
Get a Case's Board Export Jobs	GET	/v2/orgs/{{orgId}}/cases/{{caseId}}/export-jobs	conn_mod_def::GLXcPNb7Z8A::QjA_-WtWQ_-p9PjTrjaCUg
Get Board Export Job Status for an Organization	GET	/v2/orgs/{{orgId}}/boards/export/jobs/{{jobId}}	conn_mod_def::GLXcMMANOGA::FhqVY7p6TkemVdcxQJH4YA
List Board Export Jobs for an Organization	GET	/v2/orgs/{{orgId}}/boards/export/jobs	conn_mod_def::GLXcMN6RRxg::7se_bLyKRuW1KHtDCBiTQA
Create Board Export Job for an Organization	POST	/v2/orgs/{{orgId}}/boards/export/jobs	conn_mod_def::GLXcMN6RGDg::wmvrAlwMRmGFuqmH0KbOYQ
Update Board Export Job Status for an Organization	PUT	/v2/orgs/{{orgId}}/boards/export/jobs/{{jobId}}/status	conn_mod_def::GLXcMXa-anA::lsOkrHhMSUaLnHAHPLykOg

BoardMembers

Action	Method	Path	Action id
Get a Specific Board Member	GET	/v2/boards/{{boardId}}/members/{{boardMemberId}}	conn_mod_def::GLXcMWVk5xg::g3O4gV9sSpGic9_FoWa-0Q
List Board Members	GET	/v2/boards/{{boardId}}/members	conn_mod_def::GLXcMW6Py8g::q9GuMB4US4anSqde6NnEWQ
Remove a Board Member	DELETE	/v2/boards/{{boardId}}/members/{{boardMemberId}}	conn_mod_def::GLXcMW9b2hA::9KiuEcfMTSOow8K716Jtew
Share Board Members Using Boards	POST	/v2/boards/{{boardId}}/members	conn_mod_def::GLXcMf2UWEg::PmZKU6SaQsO12NGnAtrHQg
Update a Board Member	PATCH	/v2/boards/{{boardId}}/members/{{boardMemberId}}	conn_mod_def::GLXcMhx70Dg::KrT1tiaiSDa01l8fr1WKhA

CodeWidgets

Action	Method	Path	Action id
Get a Board's Code Widget Item	GET	/v2-experimental/boards/{{boardId}}/code_widgets/{{itemId}}	conn_mod_def::GLXcM-LdEmg::yV8J7SLIT0WzlawMt2MBDw
Get Code Widget Items for a Board	GET	/v2-experimental/boards/{{boardId}}/code_widgets	conn_mod_def::GLXcNBLPLkg::Hu-0JyanT_CpnrKPSQKlzg
Create Code Widget Item on a Board	POST	/v2-experimental/boards/{{boardId}}/code_widgets	conn_mod_def::GLXcM0FPzXg::B9FfTfiHQIm5WianFWFkeQ
Delete a Code Widget Item from a Board	DELETE	/v2-experimental/boards/{{boardId}}/code_widgets/{{itemId}}	conn_mod_def::GLXcM9FjMeg::MDEP1ztpTTKbJOQOACYe9Q
Move a Code Widget Item's Position on a Board	PATCH	/v2-experimental/boards/{{boardId}}/code_widgets/{{itemId}}/position	conn_mod_def::GLXcM-W5eoA::es6mstTSRCiOMtpDzwJBGA

Documents

Action	Method	Path	Action id
Get a Document Item from a Board	GET	/v2/boards/{{boardId}}/documents/{{itemId}}	conn_mod_def::GLXcNniM7tA::klul6tOaRry9keiDMJObAQ
Create a Board Document Item Using File From Device	POST	/v2/boards/{{boardIdPlatformFileUpload}}/documents	conn_mod_def::GLXcNnqyzHA::toXO2hpvRYaballLgNjMzw
Create a Document Item Using URL on a Board	POST	/v2/boards/{{boardId}}/documents	conn_mod_def::GLXcNcrz6Hg::BvimWekMSnOtP-ZhHp8dIA
Update a Board Document Item Using File From Device	PATCH	/v2/boards/{{boardIdPlatformFileUpload}}/documents/{{itemId}}	conn_mod_def::GLXcNn3TPoA::4jZzj_FQRGazxIdInVufaQ
Update a Board Document Item Using URL	PATCH	/v2/boards/{{boardId}}/documents/{{itemId}}	conn_mod_def::GLXcNni9-YA::_elhr4lgTEehERjvho-vvg

StickyNotes

Action	Method	Path	Action id
Get a Sticky Note Item from a Board	GET	/v2/boards/{{boardId}}/sticky_notes/{{itemId}}	conn_mod_def::GLXcQ891iAg::J49ZRIJsTY-rK9q0l35fkA
Create a Sticky Note Item on a Board	POST	/v2/boards/{{boardId}}/sticky_notes	conn_mod_def::GLXcQ0ZIjrg::kCOA9mjmQtarjpguzDir8Q
Delete a Board Sticky Note Item	DELETE	/v2/boards/{{boardId}}/sticky_notes/{{itemId}}	conn_mod_def::GLXcQqka8pg::cFSC1L85RZO79Jv1H9AOhw
Update Sticky Note Item on a Board	PATCH	/v2/boards/{{boardId}}/sticky_notes/{{itemId}}	conn_mod_def::GLXcQ9GBMqA::ToXfH0-rQgO5qVHbaZ6RKw

Items

Action	Method	Path	Action id
Get Items by Tag for a Board	GET	/v2/boards/{{boardIdPlatformTags}}/items	conn_mod_def::GLXcRFYF0cA::kt6kNcG_RNq8ZggGxFlWIQ

3 more Items actions are available through search.

This lists 90 of 197 actions. For anything not here, call search_one_platform_actions with platform miro. The full catalog is at https://www.withone.ai/knowledge/miro.

When a call fails

The error comes from Miro, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/miro

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.