Skill UI

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.

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 skill analyzes complex legal contracts and agreements, identifying unfavorable, high-risk, or one-sided clauses regarding liability, IP, or termination. It generates a structured negotiation strategy document, providing prioritized counter-proposals, recommended replacement language, and professional talking points to guide users through high-stakes contract reviews before signing.

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 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 advanced workflow provides comprehensive control over Notion's content structure. Use it to recursively read nested block trees, append diverse block types (headings, lists, code blocks, callouts), and apply rich text formatting (e.g., bold, link, mention). Ideal for automating complex content creation and data extraction from Notion pages.

A comprehensive script and suite of tools designed to collect highly detailed diagnostic information for troubleshooting persistent Notion API issues. This bundle gathers environment variables, SDK versions, API connectivity tests, rate limit info, and application logs into a single, structured bundle, making it essential for filing accurate support tickets with Notion support.

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.

A comprehensive wrapper for Notion API calls that implements full observability. It automatically tracks vital metrics including request rates, latency (average, p95), error counts, and rate limit status. This skill is essential for building reliable monitoring dashboards, setting up alerts, and ensuring the health of Notion integrations in production environments. It supports structured logging and Prometheus metrics.

This comprehensive skill provides a structured, actionable checklist for verifying and auditing Notion API integrations before they go live in a production environment. It covers critical areas such as environment variable security, least-privilege capability scoping, robust rate limit handling, data pagination, and comprehensive error management. Use this checklist during go-live preparation, system audits, or major feature deployments to ensure the integration is secure, stable, and fully functional.