Skill UI

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 framework for establishing governance standards across Notion integrations. It enforces naming conventions for bots, manages page sharing policies to prevent data leaks, validates database schemas (e.g., required property naming, date formats), and provides access audit scripts. Ideal for maintaining consistency and security in large, multi-team Notion environments.

This guide provides advanced patterns for managing Notion API rate limits. It details implementing robust retry logic using exponential backoff with jitter, honoring `Retry-After` headers, and utilizing queue-based throttling (e.g., with p-queue) to proactively maintain a stable request rate (3 req/s). Essential for developing high-throughput, resilient, and stable Notion integrations.

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 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.

Provides a comprehensive, production-ready deployment solution for OneNote integrations in containerized environments. This skill addresses critical issues like MSAL token persistence (supporting both file and Redis caches), implementing deep health/readiness checks that validate actual Graph API connectivity, and managing graceful shutdowns. Ideal for containerizing OneNote services for robust, scalable production use with Docker and Kubernetes.

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.

A comprehensive guide detailing the reference architecture for connecting to OneNote via the Microsoft Graph API. It covers the distinct API paths, permission models, and object hierarchies for personal (OneDrive), SharePoint, and Microsoft 365 Group notebooks, ensuring seamless design for multi-tenant, enterprise-level integrations.

This skill provides robust, production-grade patterns for interacting with the OneNote Graph API. It addresses critical issues encountered in real-world applications, such as rate limiting (429 errors), transient server failures (502/503), and silent file upload failures. It includes retry decorators, batch request strategies, and proactive rate limit tracking mechanisms for both TypeScript and Python, ensuring highly reliable integrations.

This guide provides comprehensive instructions on implementing secure authentication and managing the token lifecycle for the OneNote Graph API. It details the mandatory shift from deprecated app-only authentication to delegated authentication using MSAL, ensuring compliance with modern OAuth 2.0 standards. Key topics include establishing least-privilege permission scopes, handling token renewal, and securely storing credentials using environment variables or Azure Key Vault. Essential for developers building resilient and compliant OneNote integrations.

This skill guides developers through critical breaking changes when upgrading OneNote integrations using the Microsoft Graph SDK. It details how to migrate from app-only to delegated authentication, replace decommissioned webhooks with polling, update deprecated search endpoints to OData filters, and upgrade the Graph SDK from v5 to v6. Essential for maintaining compatibility with modern Microsoft Graph APIs.

This utility addresses the lack of webhooks for OneNote resources. It implements an efficient change detection mechanism by performing timestamp-based polling and delta query comparisons against the Microsoft Graph API. It is essential for building real-time synchronization, change monitoring, or event-driven integrations for OneNote, while carefully managing API rate limits.