notion-advanced-troubleshooting

# Notion Advanced Troubleshooting ## Overview Deep debugging techniques for Notion API issues that resist standard fixes. Covers API response inspection with request IDs, permission chain tracing through page hierarchies, property type mismatch detection against database schemas, pagination edge cases with cursor validation, and block nesting limit violations (max depth of 3 levels via API). Uses `Client` from `@notionhq/client` and raw `curl` for comparison testing. ## Prerequisites - `@notionhq/client` v2.x installed (`npm install @notionhq/client`) - Python: `notion-client` installed (`pip install notion-client`) - `curl` available for raw API testing - `NOTION_TOKEN` environment variable set (internal integration token starting with `ntn_`) - Pages/databases shared with your integration via Notion UI ## Instructions ### Step 1: API Response Inspection with Request ID Tracking Every Notion API response includes an `x-request-id` header. Capture it for debugging and support tickets. ```typescript import { Client, LogLevel, isNotionClientError, APIErrorCode } from '@notionhq/client'; const notion = new Client({ auth: process.env.NOTION_TOKEN, logLevel: LogLevel.DEBUG, // Logs full request/response to stderr }); // Wrapper that captures request ID and timing for every call async function tracedCall<T>( label: string, fn: () => Promise<T> ): Promise<{ result: T; durationMs: number }> { const start = Date.now(); try { const result = await fn(); con...