Skill UI

This skill provides comprehensive strategies to optimize resource usage and mitigate rate limits when integrating with the OneNote Graph API. It focuses on reducing the operational 'cost' of making API calls by implementing metadata caching (TTL), utilizing JSON batch requests, and performing delta synchronization instead of full list fetches. Essential for high-volume, stable OneNote enterprise integrations.

This bundle generates comprehensive diagnostic logs for troubleshooting OneNote Graph API issues. It captures critical data points—such as the `request-id`, `x-ms-ags-diagnostic` headers, full error bodies, and decoded JWT token claims—for both successful and failed API calls. Use it for self-diagnosis, verifying permissions, or preparing detailed support tickets for Microsoft support.

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.

This skill provides a comprehensive guide and code examples for creating a complete OneNote structure (Notebook, Section, and Page) using the Microsoft Graph API. It specifically addresses the critical technical requirement that OneNote content must follow strict XHTML standards, detailing common HTML pitfalls (such as unclosed tags, unsupported attributes, and merge cell usage) that can lead to silent content corruption during API calls.

Comprehensive guide for setting up delegated authentication for the OneNote Graph API using MSAL. Learn how to register applications in Azure AD, configure precise permission scopes, install SDKs (Python/TypeScript), and implement token caching. This guide specifically addresses the migration from deprecated app-only authentication methods.

This skill establishes a local development loop for OneNote integrations. It uses Mock Service Workers (MSW) to intercept calls to the Microsoft Graph API, providing realistic, fixture-based responses (e.g., Notebooks, Sections, Pages). This allows developers to rapidly build and test OneNote features without needing live Azure credentials or worrying about rate limit restrictions during development cycles.

A comprehensive guide for optimizing OneNote Graph API interactions at scale. It addresses common performance bottlenecks such as slow data retrieval from large notebooks, handling excessive image sizes, implementing efficient payload selection ($select), and paginating massive data sets using $top. Essential for building stable, high-performance automation workflows.

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.

This skill provides advanced rate limit handling for the OneNote Graph API. It implements a token bucket algorithm and queue-based throttling mechanism to prevent hitting rate limits (429 errors). It correctly parses the 'Retry-After' header and manages both per-user and per-tenant usage quotas, ensuring stable, high-throughput integrations.

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.