Skill UI

A guide to building resilient software integrations when dealing with external APIs that lack formal versioning, changelogs, or guaranteed backward compatibility. Learn defensive coding patterns, implementing schema drift detection via CLI tools (curl, jq), using fallback field names, and executing gradual feature flag rollouts to maintain production stability.

A comprehensive skill for deploying production-ready Node.js applications that utilize the Notion API to serverless platforms like Vercel, Railway, or Fly.io. This guide implements critical best practices including Notion client singletons for serverless environments, robust rate limit handling (3 req/sec), response caching strategies, and essential health check endpoints to ensure stability and scalability in production.

This skill guides users through setting up a robust, local development loop for Notion integrations. It covers creating dedicated development tokens, structuring the project for testability, implementing mocked SDK unit tests, and handling API rate limits with exponential backoff retries. This ensures rapid, reliable iteration and testing without compromising production data safety.

This guide details how to securely configure Notion integrations for separate development, staging, and production environments. It emphasizes using environment-aware client factories, dedicated tokens, and integrating with robust secret managers (AWS Secrets Manager, GCP Secret Manager, HashiCorp Vault) to ensure strict data isolation and adhere to least-privilege principles across all deployment tiers.

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.

This skill provides a comprehensive, production-grade reference architecture for building robust Notion integrations. It defines a multi-layered structure, including client singletons, repository patterns, service orchestration, and caching mechanisms. It is essential for migrating ad-hoc API calls to scalable, event-driven, and highly reliable enterprise applications that incorporate rate limiting, sophisticated error handling, and comprehensive testing strategies.

A guide to building production-grade, fault-tolerant integrations with Notion. Learn industry best practices for handling API failures, including exponential backoff retries, implementing circuit breakers to prevent cascade failures, utilizing offline caching for graceful degradation, and setting up health checks. Essential for maintaining high system uptime when interacting with the Notion API.

This guide provides production-ready patterns for integrating with the Notion API using official SDKs for TypeScript and Python. It covers advanced techniques including client initialization, executing complex database queries with filters and sorts, implementing cursor-based pagination for large datasets, constructing and manipulating rich text blocks, and ensuring robust, type-safe error handling.

A comprehensive, step-by-step guide for managing Notion API integrations. Learn how to upgrade both the Node.js (@notionhq/client) and Python (notion-client) SDKs, handle major version breaking changes, and properly manage API version pinning (e.g., 2022-06-28) to ensure stable, production-ready applications.

This comprehensive guide serves as a complete error decoder for the OneNote Graph API. It analyzes major HTTP status codes (400, 403, 404, 429, 500, 502, 507) and provides root cause analysis, diagnostic steps, and code fixes for common issues. It specifically addresses critical failure modes like deprecated authentication methods and silent 200 OK failures, helping developers debug complex API integrations in production.

A comprehensive go/no-go checklist for deploying OneNote integrations using the Microsoft Graph API. It covers critical production failure points, including advanced authentication resilience (token caching, silent renewal), rate limit handling (exponential backoff, tenant-level tracking), and explicit error code management for robust deployment. Essential for launch reviews.