Skill UI

This guide provides comprehensive procedures to diagnose and resolve common HTTP errors (401, 403, 429, 500, etc.) encountered when interacting with the Navan API. It details root causes, necessary prerequisites (like `curl` and `jq`), and step-by-step fix procedures for issues such as expired tokens, insufficient permissions, and rate limiting, helping developers ensure stable integration.

Use this comprehensive bundle to systematically collect diagnostic data from Navan API integrations. It captures critical information including OAuth token details, full API request/response payloads, network connectivity metrics, and local environment state. This tool is essential for developers and integrators needing to perform deep troubleshooting and pinpoint complex API failures.

A structured playbook for diagnosing and resolving critical disruptions within the Navan travel platform. It guides users through severity classification (P1-P4), utilizing built-in AI assistants (Ava), and performing essential API health checks using tools like curl and jq. This runbook ensures a systematic approach to handling failures related to bookings, OAuth tokens, and expense syncing, minimizing downtime and providing clear escalation paths.

This comprehensive guide details how to set up OAuth 2.0 client credentials for the Navan REST API. It provides complete, runnable code examples in both TypeScript (Node.js) and Python. Users can follow these steps to exchange client secrets for a secure bearer token, enabling programmatic access to Navan's booking and travel data. This is essential for configuring new Navan integrations or rotating API credentials.

This comprehensive guide establishes a structured local development environment for integrating with the Navan API. Since Navan does not provide a sandbox, this workflow is crucial for minimizing calls to the production API. It implements token caching to persist access tokens, detailed request logging for debugging, and mock fixtures to allow for reliable, safe offline testing during the development cycle.

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.

Use this guide when designing a robust, production-grade integration with the Navan API. It details a multi-layered architectural blueprint, including an API Gateway for rate limiting and circuit breaking, a centralized OAuth Token Management Service, secure data synchronization pipelines, and comprehensive monitoring stacks. Ideal for complex enterprise systems requiring reliable connectivity to travel and expense data.

Build a robust, typed API wrapper for Navan's REST endpoints, compensating for the lack of an official SDK. This pattern provides automated OAuth 2.0 token lifecycle management, built-in retry logic (for rate limiting and service downtime), and structured error handling, ensuring reliable, type-safe API interactions in production environments.

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.

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 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 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.