Miro Boards
CertifiedTasks for managing Miro boards: list, get, create, update, delete, and copy, plus a polling trigger for new boards.
Use these tasks to automate Miro board lifecycle management: provision boards for new projects, archive completed ones, and audit board membership from a Kestra flow.
Miro Boards
Tasks for managing Miro boards: list, get, create, update, delete, and copy, plus a polling trigger for new boards.
Use these tasks to automate Miro board lifecycle management: provision boards for new projects, archive completed ones, and audit board membership from a Kestra flow.
tasks
How to use the Miro plugin
Manage the lifecycle of Miro boards — list, get, create, update, copy, and delete — and react to new boards from Kestra flows.
Authentication
All tasks and the trigger require token (a Miro OAuth 2.0 bearer token, required). Tokens expire after 1 hour; non-expiring tokens are also supported for service accounts. Optionally set options for HTTP client configuration. Store the token in secrets (e.g. {{ secret('MIRO_TOKEN') }}) and apply connection properties globally with plugin defaults.
Tasks
boards.Create creates a board — set name (required). Optionally set boardDescription, teamId, projectId, sharingPolicy, and permissionsPolicy (the policy maps follow the Miro board policy schema). The output includes the new board id.
boards.Get retrieves a board by boardId (required), returning its full details.
boards.Update updates a board by boardId (required) — set at least one of name, boardDescription, sharingPolicy, or permissionsPolicy; only the fields you provide are changed.
boards.Copy copies a board — set sourceBoardId (required). Optionally set name (defaults to the source board name), boardDescription, and targetTeamId (defaults to the source board's team).
boards.Delete permanently deletes a board by boardId (required). This cannot be undone, and the authenticated user must have owner or administrator rights on the board.
boards.List returns a paginated list of accessible boards — all properties are optional. Filter with teamId, projectId, query (matches board name), and owner (user ID or email); order with sort (DEFAULT, LAST_MODIFIED, LAST_OPENED, LAST_OPENED_BY_ANYONE, LAST_CREATED, or ALPHABETICALLY — Miro has no descending order). Page with offset (zero-based) and limit (1–50, default 20); the output includes the boards page plus total, size, and offset for paging.
boards.Trigger polls the boards list (default PT5M) and starts an execution when new boards are created. Optionally set teamId and projectId to scope the watch, and limit (boards fetched per poll, 1–50, default 20). Detection is window-based with no persistent state: each poll fires for boards whose createdAt falls in the half-open window (pollDate - interval, pollDate]. Boards created during downtime or skipped polls, and creation bursts exceeding limit within one interval, may be missed.
