Skill UI

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.

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.

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.

This comprehensive guide establishes a structured local development environment for integrating with the Navan API. Since Navan does not provide a sandbox, this workflow is crucial for minimizing calls to the production API. It implements token caching to persist access tokens, detailed request logging for debugging, and mock fixtures to allow for reliable, safe offline testing during the development cycle.

This skill provides a comprehensive framework for setting up robust observability for Navan API integrations in production environments. It guides users through implementing structured logging, tracking request latency, classifying various errors (auth, rate limit, server), and monitoring the OAuth token refresh lifecycle. Includes practical steps and YAML examples for configuring alerts and building dashboards in platforms like Datadog, CloudWatch, or Prometheus/Grafana.

Build a robust, typed API wrapper for Navan's REST endpoints, compensating for the lack of an official SDK. This pattern provides automated OAuth 2.0 token lifecycle management, built-in retry logic (for rate limiting and service downtime), and structured error handling, ensuring reliable, type-safe API interactions in production environments.

This guide provides a comprehensive reference for diagnosing and fixing common Notion API errors. It covers critical HTTP statuses and specific error codes (such as 401 Unauthorized, 403 Restricted Resource, 404 Object Not Found, 400 Validation Error, and 429 Rate Limited). Use it when debugging failed Notion integrations, managing permissions, or resolving data structure issues for reliable development.

Provides comprehensive programmatic access to Notion, allowing users to create, update, archive, and compose rich content blocks within pages and databases. This skill covers the full page lifecycle—from initial creation with structured properties to appending complex blocks (headings, lists, toggles, code) and managing status updates. It is essential for building automated knowledge bases, automating content workflows, and programmatically managing enterprise information systems using the Notion API.

A comprehensive script and suite of tools designed to collect highly detailed diagnostic information for troubleshooting persistent Notion API issues. This bundle gathers environment variables, SDK versions, API connectivity tests, rate limit info, and application logs into a single, structured bundle, making it essential for filing accurate support tickets with Notion support.

A comprehensive runbook for rapidly responding to Notion API incidents. It provides structured triage flows, automated health checks, and a decision tree to classify failures (Notion-side vs. integration-side). Use it for immediate diagnosis of outages, error mitigation (e.g., rate limits, token expiry), and post-incident reviews.

A comprehensive wrapper for Notion API calls that implements full observability. It automatically tracks vital metrics including request rates, latency (average, p95), error counts, and rate limit status. This skill is essential for building reliable monitoring dashboards, setting up alerts, and ensuring the health of Notion integrations in production environments. It supports structured logging and Prometheus metrics.

This comprehensive skill provides a structured, actionable checklist for verifying and auditing Notion API integrations before they go live in a production environment. It covers critical areas such as environment variable security, least-privilege capability scoping, robust rate limit handling, data pagination, and comprehensive error management. Use this checklist during go-live preparation, system audits, or major feature deployments to ensure the integration is secure, stable, and fully functional.