onenote-common-errors

Featured

Decode and fix every common OneNote Graph API error with root cause analysis. Use when debugging 400, 403, 404, 429, 500, 502, or 507 errors from OneNote API. Trigger with "onenote error", "onenote 403", "onenote debug", "graph api error onenote".

AI & Automation 2,266 stars 315 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# OneNote Common Errors ## Overview A complete error decoder for the OneNote Graph API. Each HTTP status code has multiple possible root causes — this skill maps every cause, provides diagnostic steps, and gives fix-it code. Special attention to the two trickiest errors: 403 (which could mean wrong permissions OR deprecated app-only auth) and 200 with empty body (silent upload failure that causes data loss). ## Prerequisites - A OneNote Graph API integration that is returning errors - Access to application logs or the ability to add logging - Familiarity with the Graph API request/response format ## Instructions ### Complete Error Reference Table | Code | Error Name | Possible Causes | Fix | |------|-----------|-----------------|-----| | 400 | Bad Request | (1) Invalid XHTML — unclosed tags, bad encoding | Validate HTML with XML parser before sending | | | | (2) Bad notebook name — empty or duplicate `displayName` | Check for existing notebooks, use unique names | | | | (3) Malformed JSON in PATCH body | Validate JSON structure matches [update spec](https://learn.microsoft.com/en-us/graph/onenote-update-page) | | | | (4) Missing `<title>` in page HTML | Always include `<head><title>...</title></head>` | | | | (5) Invalid `$filter` OData expression | Check [OData query syntax](https://learn.microsoft.com/en-us/graph/api/resources/onenote-api-overview) | | 403 | Forbidden | (1) **App-only auth (deprecated March 2025)** | Switch to delegated auth (DeviceCodeCredential) | ...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
7 months ago
Last Updated
today
Language
Python
License
MIT

Integrates with

Anthropic · AI

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Featured

onenote-debug-bundle

Generate comprehensive diagnostic bundles for OneNote Graph API issues with request tracing and token analysis. Use when debugging OneNote API failures, filing Microsoft support tickets, or analyzing permission issues. Trigger with "onenote debug", "onenote diagnostic", "onenote support ticket", "graph api troubleshoot onenote".

2,266 Updated today
jeremylongshore
AI & Automation Featured

onenote-performance-tuning

Optimize OneNote Graph API performance for large notebooks, image handling, and batch operations. Use when dealing with slow API responses, large notebooks, image uploads, or HTTP 507 errors. Trigger with "onenote performance", "onenote slow", "onenote large notebook", "onenote image upload".

2,266 Updated today
jeremylongshore
AI & Automation Featured

onenote-security-basics

Implement secure authentication, token management, and permission scoping for OneNote Graph API. Use when hardening OneNote integrations, implementing least-privilege permissions, or managing token lifecycle. Trigger with "onenote security", "onenote permissions", "onenote token management", "onenote least privilege".

2,266 Updated today
jeremylongshore
AI & Automation Featured

onenote-upgrade-migration

Migrate OneNote integrations across Graph SDK versions, auth deprecations, and API changes. Use when upgrading Graph SDK, migrating from app-only to delegated auth, or handling deprecated endpoints. Trigger with "onenote upgrade", "onenote migration", "graph sdk upgrade", "onenote breaking changes".

2,266 Updated today
jeremylongshore
AI & Automation Featured

onenote-prod-checklist

Production readiness checklist for OneNote Graph API integrations covering auth, rate limits, and failure modes. Use when preparing a OneNote integration for production deployment or conducting a launch review. Trigger with "onenote production checklist", "onenote launch review", "onenote prod ready".

2,266 Updated today
jeremylongshore