Skill UI

Designed to handle API integrations for services like Navan that lack a dedicated sandbox environment. This skill implements robust environment isolation (Development, Staging, Production) using separate OAuth credentials, advanced environment variable management, and a local development proxy/mock server. It ensures that development, testing, and CI/CD processes can run safely without modifying live production data.

This skill provides a comprehensive framework for setting up robust observability for Navan API integrations in production environments. It guides users through implementing structured logging, tracking request latency, classifying various errors (auth, rate limit, server), and monitoring the OAuth token refresh lifecycle. Includes practical steps and YAML examples for configuring alerts and building dashboards in platforms like Datadog, CloudWatch, or Prometheus/Grafana.

This skill provides advanced architectural patterns for optimizing high-volume integrations with the Navan API. It addresses common bottlenecks like rate limiting, sequential calls, and naive pagination by implementing robust solutions such as data-type-specific response caching, controlled parallel fetching with concurrency throttling, efficient cursor-based pagination, and HTTP connection reuse. Use this when building scalable, reliable, and high-throughput systems.

A comprehensive guide to securing Navan integrations and API access. This skill covers OAuth 2.0 best practices, secure credential storage, automated credential rotation, configuring Single Sign-On (SSO) via SAML/OpenID Connect, and implementing automated user lifecycle management using SCIM provisioning. Essential for hardening enterprise-level integrations.

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.

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.

This comprehensive workflow provides core CRUD (Create, Read, Update, Delete) operations for Notion integrations. It allows users to perform complex database queries using nested filters (AND/OR) across various property types (select, date, number, etc.). Furthermore, it facilitates the structured creation and updating of pages, making it essential for automating data management, content generation, and complex information retrieval within Notion.

This skill provides robust methods for handling sensitive data within Notion integrations. It systematically detects Personally Identifiable Information (PII), such as emails, phone numbers, SSNs, and credit cards, within both page properties and rich text content. Users can implement data redaction mechanisms before logging or exporting, ensuring the data handling process fully complies with major privacy regulations like GDPR and CCPA.

This guide provides a comprehensive blueprint for implementing enterprise-grade Role-Based Access Control (RBAC) for Notion integrations. It covers the full OAuth 2.0 flow for public, multi-tenant apps, secure per-workspace token storage (with encryption), and layering custom permission models (admin/editor/viewer) over Notion's native permissions. Essential for building robust, secure, and audit-compliant Notion applications.

This guide provides a comprehensive walkthrough for installing and configuring the Notion API SDK in both Node.js and Python environments. It covers creating internal integrations, securely setting environment variables for the API token, and verifying connectivity. Necessary for any developer building applications that interact with Notion workspaces and databases.

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.