Skill UI

This guide details the most common and tricky mistakes developers encounter when building integrations with the Notion API. It covers critical pitfalls such as incorrect page ID formats, handling rich text arrays, ensuring proper page sharing permissions, and correctly retrieving nested block content. Essential reading for debugging and optimizing Notion-related code.

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.

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.

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.

This skill provides a comprehensive solution for deploying containerized applications to Oracle Cloud Infrastructure (OCI). It supports two primary deployment paths: OKE (Oracle Kubernetes Engine) for full Kubernetes orchestration, and Container Instances for a simpler, serverless alternative. Use this skill for automating the entire lifecycle, including pushing images to OCIR, provisioning OKE clusters via Python SDK, and executing Kubernetes deployments using kubectl.