Skill UI

A guide to building resilient software integrations when dealing with external APIs that lack formal versioning, changelogs, or guaranteed backward compatibility. Learn defensive coding patterns, implementing schema drift detection via CLI tools (curl, jq), using fallback field names, and executing gradual feature flag rollouts to maintain production stability.

Provides advanced debugging techniques for Notion API issues that standard troubleshooting cannot resolve. It covers response ID inspection, tracing complex permission chains, detecting property type mismatches, managing pagination edge cases, and resolving block nesting limits across Notion databases and pages. Essential for robust integration development.

A comprehensive guide detailing five validated architecture patterns for utilizing Notion as a powerful backend database. Use cases include: Headless CMS for blogging, task tracking for project management, building knowledge bases (wikis), handling form submissions, and serving as a data pipeline source. Includes schema design and code examples using TypeScript and Python.

This guide provides a comprehensive reference for diagnosing and fixing common Notion API errors. It covers critical HTTP statuses and specific error codes (such as 401 Unauthorized, 403 Restricted Resource, 404 Object Not Found, 400 Validation Error, and 429 Rate Limited). Use it when debugging failed Notion integrations, managing permissions, or resolving data structure issues for reliable development.

Provides comprehensive programmatic access to Notion, allowing users to create, update, archive, and compose rich content blocks within pages and databases. This skill covers the full page lifecycle—from initial creation with structured properties to appending complex blocks (headings, lists, toggles, code) and managing status updates. It is essential for building automated knowledge bases, automating content workflows, and programmatically managing enterprise information systems using the Notion API.

This guide provides three fundamental examples for integrating with the Notion API. It demonstrates how to search for existing pages, create new content within a database, and retrieve the newly created page's metadata. Ideal for developers starting a new Notion integration or implementing basic automated workflows.

A comprehensive runbook for rapidly responding to Notion API incidents. It provides structured triage flows, automated health checks, and a decision tree to classify failures (Notion-side vs. integration-side). Use it for immediate diagnosis of outages, error mitigation (e.g., rate limits, token expiry), and post-incident reviews.

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 skill guides users through setting up a robust, local development loop for Notion integrations. It covers creating dedicated development tokens, structuring the project for testability, implementing mocked SDK unit tests, and handling API rate limits with exponential backoff retries. This ensures rapid, reliable iteration and testing without compromising production data safety.

This guide provides advanced strategies for optimizing interactions with the Notion API. Learn best practices such as implementing Time-To-Live (TTL) caching, batching multiple block updates, avoiding inefficient N+1 query patterns, and managing rate limits. Use this when your Notion application suffers from slow responses, high latency, or excessive API call consumption.

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.