Skill UI

A comprehensive guide for developers on installing and configuring the official @mirohq/miro-api Node.js client. This skill provides step-by-step instructions for setting up the full OAuth 2.0 authorization code flow, managing client credentials, and implementing token refresh patterns to ensure secure and reliable access to the Miro REST API v2. Use this when building automated applications or integrating Miro features into a custom backend service.

This skill provides a comprehensive guide to setting up a robust local development workflow for building Miro integrations. It encompasses hot reloading for rapid iteration, structured unit and integration testing using Vitest, and configuring ngrok tunneling for simulating real-world webhooks and interacting with the Miro REST API v2.

A comprehensive guide for migrating complex Miro board data across teams and organizations. It covers exporting board content—including items, connectors, tags, and members—to structured JSON files, and bulk-importing data into Miro using the REST API v2. Ideal for re-platforming from competing whiteboard tools or updating large-scale, legacy v1 integrations.

Provides comprehensive observability for Miro REST API v2 integrations. It captures critical metrics using Prometheus (request rates, latency, error tracking) and OpenTelemetry traces for end-to-end request flow visibility. Includes structured logging for detailed debugging and robust rate limit management, ensuring your applications are highly reliable and maintainable.

This guide provides advanced best practices for optimizing interactions with the Miro REST API v2. It covers essential patterns like cursor-based pagination to prevent over-fetching, implementing robust caching strategies (In-Memory/Redis) for reduced latency, and managing connections and concurrency for reliable bulk operations. It is designed for building scalable, high-throughput, and efficient integrations into Miro.

A comprehensive checklist for deploying Miro REST API v2 integrations into a production environment. This guide covers critical best practices including OAuth scope minimization, robust error handling, rate limit management, implementing circuit breakers, health checking, and defining clear rollback procedures. Use this when moving any Miro-integrated application to a live, customer-facing state.

This skill implements a comprehensive solution for managing Miro REST API rate limits. It incorporates a credit-based monitoring system, exponential backoff with jitter, and request queuing. This ensures reliable, high-throughput data integration by respecting Miro's usage quotas and handling API throttling (429 errors) gracefully.

A comprehensive, production-ready reference architecture for integrating with the Miro REST API v2. It implements modern layered design principles, managing OAuth 2.0 token lifecycles, processing webhooks, and providing robust services for board synchronization, item creation, and data caching. Ideal for building complex, scalable enterprise SaaS integrations.

A comprehensive guide providing production-ready, structured patterns for interacting with the Miro API. It covers best practices for both the high-level stateful client usage and the low-level REST API v2. Includes patterns for implementing robust Board Services (fetching, pagination) and Item Factories (creating various elements like sticky notes, shapes, and cards). Essential for developers building SaaS applications or complex automation workflows using Miro.

A comprehensive guide for developers implementing secure integrations with the Miro REST API v2. This guide covers critical security best practices, including OAuth 2.0 scope minimization, robust token lifecycle management (refreshing tokens), verifying webhooks using signatures, and implementing client secret rotation protocols. Essential for building reliable and secure SaaS applications connected to Miro.

This comprehensive guide assists developers migrating their Miro integrations from REST API v1 to v2. It details key breaking changes, such as 'Widget' becoming 'Item' and 'Line' becoming 'Connector,' provides updated endpoint maps, and offers step-by-step instructions for upgrading the `@mirohq/miro-api` SDK and adapting request/response payloads. Use this resource when updating your integration to handle the latest Miro platform standards and data structures.

Implements comprehensive webhook handling for Miro boards. This solution allows external applications to subscribe to real-time events (create, update, delete) occurring on specific boards. It covers board subscription creation, event payload parsing, signature verification, and robust asynchronous event processing using TypeScript/Express.js, enabling seamless integration with external systems.