{
  "name": "Cloudflare AI Gateway",
  "slug": "cloudflare-ai-gateway",
  "website_url": "https://developers.cloudflare.com/ai-gateway/",
  "vendor_description": "\"Connect to any model, dynamically route requests, and manage usage, billing, and logs from one unified gateway.\"",
  "categories": [
    "ai-gateways"
  ],
  "summary": "Cloudflare AI Gateway is a unified proxy layer for teams routing requests across multiple LLM providers, offering automatic fallback, response caching, rate limiting, spend controls, and centralized observability from a single endpoint. Core features including analytics, caching, and rate limiting are free on all plans with 100,000 logs per account; paid plans expand log capacity and gateway count, and an enterprise tier adds HIPAA coverage and Logpush. The gateway is OpenAI and Anthropic API-compatible, supports bring-your-own-key management, and holds SOC 2 Type II, ISO 27001, PCI DSS, and GDPR certifications. A 5% fee applies to credits purchased through Unified Billing, while provider inference pricing passes through without markup.",
  "capabilities": {
    "supported_actions": [
      "unified_chat_completions",
      "openai_compatible_api",
      "anthropic_compatible_api",
      "model_routing",
      "automatic_fallback",
      "dynamic_routing",
      "rate_limiting",
      "exact_match_caching",
      "prompt_caching",
      "spend_limits",
      "budgets",
      "observability_logging",
      "analytics",
      "cost_tracking",
      "guardrails",
      "pii_redaction",
      "dlp_scanning",
      "byo_provider_keys",
      "custom_costs",
      "custom_metadata",
      "opentelemetry_tracing",
      "workers_logpush",
      "websocket_support",
      "evaluations",
      "audit_logs",
      "graphql_analytics_api"
    ],
    "supported_regions": [],
    "supported_languages": [],
    "input_types": [
      "chat completions",
      "text completions",
      "image generation",
      "text-to-speech",
      "automatic speech recognition",
      "embeddings",
      "agentic workflows (responses API)"
    ],
    "output_types": [
      "streaming (SSE)",
      "JSON",
      "OpenAI-compatible response",
      "Anthropic-compatible response"
    ],
    "webhooks_supported": false,
    "sandbox_available": false,
    "sdk_languages": [
      "JavaScript/TypeScript",
      "JavaScript/TypeScript (OpenAI SDK drop-in)"
    ],
    "mcp_server_available": true
  },
  "integration": {
    "api_style": "rest",
    "base_url": "https://api.cloudflare.com/client/v4/accounts/{account_id}/ai",
    "api_version": "v1",
    "versioning_scheme": "url",
    "stability": "ga",
    "deprecation_policy_url": "https://developers.cloudflare.com/fundamentals/api/reference/deprecations/",
    "auth_methods": [
      "api_key"
    ],
    "auth_docs_url": "https://developers.cloudflare.com/ai-gateway/configuration/authentication/",
    "idempotency_supported": null,
    "error_format": "vendor-specific",
    "webhook_signing": null,
    "webhook_events_url": null,
    "rate_limit_requests": 200,
    "rate_limit_window": "minute",
    "sdk_packages": [
      {
        "package": "ai-gateway-provider",
        "language": "JavaScript/TypeScript",
        "official": true,
        "repo_url": "https://github.com/cloudflare/ai/tree/main/packages/ai-gateway-provider"
      },
      {
        "package": "openai",
        "language": "JavaScript/TypeScript (OpenAI SDK drop-in)",
        "official": false,
        "repo_url": "https://github.com/openai/openai-node"
      }
    ],
    "mcp_url": "https://ai-gateway.mcp.cloudflare.com/mcp",
    "quickstart_url": "https://developers.cloudflare.com/ai-gateway/get-started/"
  },
  "pricing": {
    "pricing_model": "hybrid",
    "has_published_pricing": true,
    "starting_price_usd": null,
    "price_basis": null,
    "free_tier_available": true,
    "free_tier_limit": "Core features (analytics, caching, rate limiting) free on all plans; 100,000 logs/account on free plan",
    "free_tier_details": "Core features (dashboard analytics, caching, rate limiting) are free on all Cloudflare plans. Workers Free plan includes 100,000 logs per account across all gateways. DLP scanning is free on all plans (2 predefined profiles without Zero Trust subscription).",
    "minimum_commitment": null,
    "self_serve_signup": true,
    "requires_sales_call": false,
    "requires_verification": false,
    "enterprise_plan_available": true,
    "price_points": [
      {
        "plan": "Workers Free",
        "item": "Gateway core features (analytics, caching, rate limiting)",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "month",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      },
      {
        "plan": "Workers Free",
        "item": "Persistent log storage",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "100,000 logs total across all gateways",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      },
      {
        "plan": "Workers Paid",
        "item": "Persistent log storage",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "10,000,000 logs per gateway",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      },
      {
        "plan": "Workers Paid",
        "item": "Logpush base allowance",
        "amount_usd": "0.0000",
        "amount_percent": null,
        "per": "10,000,000 requests/month",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      },
      {
        "plan": "Workers Paid",
        "item": "Logpush overage",
        "amount_usd": "0.0500",
        "amount_percent": null,
        "per": "1,000,000 requests",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      },
      {
        "plan": null,
        "item": "Unified Billing credit purchase fee",
        "amount_usd": null,
        "amount_percent": "5.0000",
        "per": "% of credits purchased",
        "currency": "USD",
        "source_url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/"
      }
    ]
  },
  "compliance": {
    "soc2": "type_2",
    "hipaa": true,
    "gdpr": true,
    "iso_27001": true,
    "pci_dss": true,
    "sla_published": true,
    "sla_url": "https://www.cloudflare.com/business-sla/",
    "data_retention_policy_url": "https://www.cloudflare.com/privacypolicy/",
    "documented_rate_limits": "Free plan: 100,000 logs per account; Paid plan: 10,000,000 logs per gateway; log storage rate: 500 logs per second per gateway; individual log size: 10 MB; Unified Billing request rate: 200 requests per 60 seconds per gateway; cacheable request size: 25 MB per request; cache TTL max: 1 month; free plan: 10 gateways per account; paid plan: 20 gateways per account",
    "known_restrictions": [
      "AI Gateway is not compatible with Cloudflare Regional Services or Geo Key Manager (no data residency controls)",
      "HIPAA BAA only available for Enterprise customers",
      "Logpush only available on Workers Paid plan",
      "Guardrails pricing scales with token usage via Workers AI inference",
      "Unified Billing applies a 5% fee to all credits purchased (inference pricing from providers is passed through with no markup)",
      "Free plan DLP limited to 2 predefined profiles (full suite requires Zero Trust subscription)",
      "Cache applies exact-match only; semantic caching not yet available (planned for future release)",
      "AI Gateway token permissions cannot be restricted to a single gateway - tokens grant access to all gateways in an account"
    ]
  },
  "developer": {
    "docs_url": "https://developers.cloudflare.com/api/",
    "api_reference_url": "https://developers.cloudflare.com/fundamentals/api/reference/sdks/",
    "openapi_spec_url": null,
    "postman_collection_url": null,
    "changelog_url": "https://developers.cloudflare.com/changelog",
    "status_page_url": null,
    "llms_txt_url": "https://developers.cloudflare.com/llms.txt",
    "markdown_docs_url": null,
    "rendering": "static"
  },
  "adoption": {
    "launched_at": "2023-09-27",
    "ga_date": "2024-05-22",
    "github_stars": null,
    "github_stars_at": null,
    "notable_customers": [
      "RightBlogger"
    ]
  },
  "scores": {
    "agent_friendliness": 65,
    "pricing_transparency": 75,
    "setup_speed": 80,
    "docs_quality": 55,
    "procurement_friction": 90,
    "trust_readiness": 100,
    "best_for": [
      "Prototypes and side projects - free to start, no sales call",
      "Regulated or enterprise workloads - compliance attestations and an enterprise plan",
      "AI agents and automation - an agent-ready surface (MCP / llms.txt)"
    ],
    "avoid_if": []
  },
  "sources": [
    {
      "field": "vendor_description",
      "url": "https://www.cloudflare.com/developer-platform/products/ai-gateway/",
      "excerpt": "Connect to any model, dynamically route requests, and manage usage, billing, and logs from one unified gateway.",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://developers.cloudflare.com/ai-gateway/",
      "excerpt": "Observe and control your AI applications — Analytics tracking requests, tokens, and operational costs; Logging for request insights and error diagnosis; Caching to serve responses from Cloudflare's edge instead of origin providers; Rate limiting; Request retry and model fallback mechanisms",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://developers.cloudflare.com/ai-gateway/features/caching/",
      "excerpt": "This means caching is based on exact match of the entire request. We plan on adding semantic search for caching in the future to improve cache hit rates.",
      "confidence": "high"
    },
    {
      "field": "pricing_model",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "AI Gateway's core features available today are offered for free... A 5% fee is applied to all credits purchased through Unified Billing... Logpush is only available on the Workers Paid plan. Pricing: 10 million requests monthly included; additional requests cost $0.05 per million.",
      "confidence": "high"
    },
    {
      "field": "free_tier_details",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "Workers Free: 100,000 logs total [per account]. Workers Paid: 10,000,000 logs per gateway. DLP scanning is free on all plans.",
      "confidence": "high"
    },
    {
      "field": "documented_rate_limits",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/limits/",
      "excerpt": "Log storage rate: 500 logs per second per gateway; Individual log size: 10 MB per log; Unified Billing request rate: 200 requests per 60 seconds per gateway; Cacheable request size: 25 MB per request; Cache TTL: 1 month",
      "confidence": "high"
    },
    {
      "field": "vendor_description",
      "url": "https://developers.cloudflare.com/ai-gateway/",
      "excerpt": "Observe and control your AI applications.",
      "confidence": "high"
    },
    {
      "field": "categories",
      "url": "https://developers.cloudflare.com/ai-gateway/observability/",
      "excerpt": "Monitor AI Gateway traffic with analytics, logging, cost tracking, and OpenTelemetry integration",
      "confidence": "high"
    },
    {
      "field": "supported_actions",
      "url": "https://developers.cloudflare.com/ai-gateway/observability/",
      "excerpt": "Monitor AI Gateway traffic with analytics, logging, cost tracking, and OpenTelemetry integration",
      "confidence": "high"
    },
    {
      "field": "free_tier_available",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "AI Gateway's core features available today are offered for free, including dashboard analytics, caching, and rate limiting. Only a Cloudflare account and basic setup required.",
      "confidence": "high"
    },
    {
      "field": "free_tier_details",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/limits/",
      "excerpt": "Free Plan — Gateways: 10 per account; Log storage: 100,000 per account across all gateways; Logpush jobs: 4 per account",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://www.cloudflare.com/trust-hub/",
      "excerpt": "Cloudflare protects our customers and their users by complying with a wide range of important security certifications... ISO 27001, ISO 27701, PCI DSS, SOC 2 Type II",
      "confidence": "high"
    },
    {
      "field": "hipaa",
      "url": "https://blog.cloudflare.com/updates-to-cloudflare-security-and-privacy-certifications-and-reports/",
      "excerpt": "Enterprise security product customers can leverage Business Associate Agreements for healthcare data protection compliance.",
      "confidence": "high"
    },
    {
      "field": "iso_27001",
      "url": "https://blog.cloudflare.com/updates-to-cloudflare-security-and-privacy-certifications-and-reports/",
      "excerpt": "ISO 27001:2013 — Certified since 2019, demonstrating a formal information security management program that adheres to a globally recognized standard.",
      "confidence": "high"
    },
    {
      "field": "sla_published",
      "url": "https://www.cloudflare.com/business-sla/",
      "excerpt": "100% Uptime. The Service will serve Customer Content 100% of the time without qualification.",
      "confidence": "medium"
    },
    {
      "field": "known_restrictions",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "A 5% fee is applied to all credits purchased through Unified Billing. inference pricing from providers is passed through with no markup.",
      "confidence": "high"
    },
    {
      "field": "webhooks_supported",
      "url": "https://blog.cloudflare.com/ai-gateway-spend-limits/",
      "excerpt": "the team is working to add the capability for you to also send alerts when a limit is reached, indicating alert functionality is in development but not yet available.",
      "confidence": "medium"
    },
    {
      "field": "sdk_languages",
      "url": "https://developers.cloudflare.com/fundamentals/api/reference/sdks/",
      "excerpt": "Cloudflare currently offers the following SDKs [for Go, TypeScript, and Python] allowing developers to interact with the Cloudflare API in language-specific syntax",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.cloudflare.com/ai-gateway/get-started/",
      "excerpt": "Authenticate with your upstream AI provider using one of the following options: Unified Billing, BYOK (Store Keys), Request headers",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/rest-api/",
      "excerpt": "The /ai/v1/chat/completions endpoint is compatible with the OpenAI SDK and other OpenAI-compatible clients.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/rest-api/",
      "excerpt": "Base URL: https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/",
      "confidence": "high"
    },
    {
      "field": "soc2",
      "url": "https://blog.cloudflare.com/updates-to-cloudflare-security-and-privacy-certifications-and-reports/",
      "excerpt": "Cloudflare maintains annual SOC reports covering security, confidentiality, and availability trust principles with third-party assessor engagement yearly.",
      "confidence": "high"
    },
    {
      "field": "gdpr",
      "url": "https://blog.cloudflare.com/updates-to-cloudflare-security-and-privacy-certifications-and-reports/",
      "excerpt": "ISO 27701:2019 certification as both data processor and controller, providing assurance that we have a formal privacy program that is aligned to GDPR.",
      "confidence": "high"
    },
    {
      "field": "pci_dss",
      "url": "https://blog.cloudflare.com/updates-to-cloudflare-security-and-privacy-certifications-and-reports/",
      "excerpt": "PCI DSS — Evaluated annually as a Level 1 Merchant and Service Provider by a Qualified Security Assessor, enabling secure payment data transmission.",
      "confidence": "high"
    },
    {
      "field": "known_restrictions",
      "url": "https://developers.cloudflare.com/ai-gateway/features/caching/",
      "excerpt": "This means caching is based on exact match of the entire request. We plan on adding semantic search for caching in the future to improve cache hit rates.",
      "confidence": "high"
    },
    {
      "field": "mcp_server_available",
      "url": "https://developers.cloudflare.com/agents/model-context-protocol/mcp-servers-for-cloudflare/",
      "excerpt": "AI Gateway server — available at https://ai-gateway.mcp.cloudflare.com/mcp and enables users to search your logs, get details about the prompts and responses.",
      "confidence": "high"
    },
    {
      "field": "enterprise_plan_available",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "If you are an Enterprise customer, reach out to your account team to confirm pricing details.",
      "confidence": "high"
    },
    {
      "field": "auth_methods",
      "url": "https://developers.cloudflare.com/ai-gateway/configuration/authentication/",
      "excerpt": "REST API (api.cloudflare.com): Use the standard \"Authorization\" header with your Cloudflare API token. Provider-native endpoints (gateway.ai.cloudflare.com): Use the \"cf-aig-authorization\" header instead.",
      "confidence": "high"
    },
    {
      "field": "auth_docs_url",
      "url": "https://developers.cloudflare.com/ai-gateway/configuration/authentication/",
      "excerpt": "Add security by requiring a valid authorization token for each request.",
      "confidence": "high"
    },
    {
      "field": "api_style",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/chat-completion/",
      "excerpt": "The gateway automatically creates a \"default\" gateway on first request. Developers can integrate using standard OpenAI SDKs by simply changing the baseURL configuration point to the Cloudflare gateway.",
      "confidence": "high"
    },
    {
      "field": "base_url",
      "url": "https://developers.cloudflare.com/ai-gateway/providers/openai/",
      "excerpt": "The base URL structure is: https://gateway.ai.cloudflare.com/v1/{account_id}/{gateway_id}/openai. Replace the standard OpenAI endpoint (https://api.openai.com/v1) with this gateway URL in your requests.",
      "confidence": "high"
    },
    {
      "field": "versioning_scheme",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/rest-api/",
      "excerpt": "https://api.cloudflare.com/client/v4/accounts/$CLOUDFLARE_ACCOUNT_ID/ai/v1/chat/completions",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://developers.cloudflare.com/fundamentals/api/reference/deprecations/",
      "excerpt": "Cloudflare adds API deprecation notices to the API deprecations page by deprecation date and not alphabetically by endpoint.",
      "confidence": "medium"
    },
    {
      "field": "sdk_packages",
      "url": "https://github.com/cloudflare/ai/blob/main/packages/ai-gateway-provider/README.md",
      "excerpt": "The ai-gateway-provider project has been adopted by Cloudflare and is now maintained in the official Cloudflare AI repository at github.com/cloudflare/ai.",
      "confidence": "high"
    },
    {
      "field": "mcp_url",
      "url": "https://developers.cloudflare.com/agents/model-context-protocol/mcp-servers-for-cloudflare/",
      "excerpt": "Cloudflare provides a dedicated AI Gateway server at https://ai-gateway.mcp.cloudflare.com/mcp. This server enables users to \"search your logs, get details about the prompts and responses.\"",
      "confidence": "high"
    },
    {
      "field": "rate_limit_requests",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/limits/",
      "excerpt": "Unified Billing request rate: \"200 requests per 60 seconds per gateway\"",
      "confidence": "high"
    },
    {
      "field": "requires_verification",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "Core features available today are offered for free. Users only need a Cloudflare account and basic setup.",
      "confidence": "high"
    },
    {
      "field": "data_retention_policy_url",
      "url": "https://www.cloudflare.com/privacypolicy/",
      "excerpt": "We store your personal information for a period of time that is consistent with the business purposes set forth in Section 3 or as legally required.",
      "confidence": "medium"
    },
    {
      "field": "free_tier_limit",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "A 5% fee is applied to all credits purchased through Unified Billing. Provider inference pricing carries no markup.",
      "confidence": "high"
    },
    {
      "field": "ga_date",
      "url": "https://blog.cloudflare.com/ai-gateway-is-generally-available/",
      "excerpt": "GA Announcement Date: May 22, 2024. The platform had proxied over 500 million requests during its beta period before reaching general availability.",
      "confidence": "high"
    },
    {
      "field": "api_version",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/rest-api/",
      "excerpt": "POST /ai/v1/chat/completions — OpenAI chat completions format; POST /ai/v1/responses — OpenAI Responses API; POST /ai/v1/messages — Anthropic Messages API format",
      "confidence": "high"
    },
    {
      "field": "stability",
      "url": "https://blog.cloudflare.com/ai-gateway-is-generally-available/",
      "excerpt": "GA Announcement Date: May 22, 2024. The platform had proxied over 500 million requests during its beta period before reaching general availability.",
      "confidence": "high"
    },
    {
      "field": "deprecation_policy_url",
      "url": "https://developers.cloudflare.com/ai-gateway/usage/universal/",
      "excerpt": "The Universal Endpoint will continue to work for existing integrations. However, new projects should adopt the replacement solutions.",
      "confidence": "medium"
    },
    {
      "field": "sdk_packages",
      "url": "https://developers.cloudflare.com/changelog/post/2025-12-22-agents-sdk-ai-sdk-v6/",
      "excerpt": "npm install agents@^0.3.0 workers-ai-provider@^3.0.0 ai-gateway-provider@^3.0.0 ai@^6.0.0 @ai-sdk/react@^3.0.0 @ai-sdk/openai@^3.0.0",
      "confidence": "high"
    },
    {
      "field": "quickstart_url",
      "url": "https://developers.cloudflare.com/ai-gateway/get-started/",
      "excerpt": "Execute a POST request to https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/ai/v1/chat/completions",
      "confidence": "high"
    },
    {
      "field": "rate_limit_window",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/limits/",
      "excerpt": "Unified Billing request rate: \"200 requests per 60 seconds per gateway\"",
      "confidence": "high"
    },
    {
      "field": "sla_url",
      "url": "https://www.cloudflare.com/business-sla/",
      "excerpt": "Cloudflare's Business tier commits to \"100% Uptime. The Service will serve Customer Content 100% of the time without qualification.\"",
      "confidence": "medium"
    },
    {
      "field": "free_tier_limit",
      "url": "https://developers.cloudflare.com/ai-gateway/reference/pricing/",
      "excerpt": "Core features include: dashboard analytics, caching, and rate limiting. Workers Free plan allows 100,000 logs total across all gateways.",
      "confidence": "high"
    },
    {
      "field": "launched_at",
      "url": "https://blog.cloudflare.com/announcing-ai-gateway/",
      "excerpt": "Original Launch/Beta Date: September 27, 2023. Announced during Cloudflare's \"Birthday Week\"",
      "confidence": "high"
    },
    {
      "field": "notable_customers",
      "url": "https://www.cloudflare.com/case-studies/rightblogger/",
      "excerpt": "AI Gateway caches about 10% of the API requests and delivers results that are approximately 99% faster than LLM-generated responses, saving 10% of the costs for OpenAI per month.",
      "confidence": "high"
    }
  ],
  "fields_not_found": [
    "specific uptime SLA percentage for AI Gateway (general Cloudflare Business SLA exists but not AI Gateway-specific)",
    "explicit list of all 30+ provider names in official docs (24 confirmed from providers page)",
    "semantic caching (documented as planned, not yet available)",
    "idempotency_supported",
    "webhook_signing",
    "webhook_events_url",
    "error_format_schema"
  ],
  "source_confidence": "high",
  "last_verified_at": "2026-06-21T00:00:00.000Z",
  "contribute": {
    "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.",
    "endpoints": [
      {
        "action": "review",
        "label": "Leave a review or comment",
        "method": "POST",
        "url": "https://apio.sh/api/feedback/cloudflare-ai-gateway",
        "example_body": {
          "kind": "review",
          "rating": 5,
          "body": "Your experience with this API…"
        }
      },
      {
        "action": "field_edit",
        "label": "Suggest a correction to a field (cite a source)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/cloudflare-ai-gateway/{field}",
        "example_body": {
          "value": "corrected value",
          "citations": [
            {
              "url": "https://source.example/page",
              "excerpt": "supporting quote"
            }
          ],
          "note": "what changed and why"
        }
      },
      {
        "action": "new_api",
        "label": "Suggest a new API to add (only name is required - send as much as you can cite)",
        "method": "POST",
        "url": "https://apio.sh/api/suggest/api",
        "example_body": {
          "value": {
            "name": "Acme Email API",
            "website_url": "https://acme.example",
            "vendor_name": "Acme",
            "categories": [
              "email"
            ],
            "pricing_model": "usage_based",
            "has_published_pricing": true,
            "free_tier_available": true,
            "price_points": [
              {
                "plan": "Pay as you go",
                "item": "1,000 emails",
                "amount_usd": 1,
                "per": "1,000 emails",
                "source_url": "https://acme.example/pricing"
              }
            ],
            "soc2": "type_2",
            "docs_url": "https://docs.acme.example"
          },
          "citations": [
            {
              "url": "https://acme.example/pricing",
              "excerpt": "$1 per 1,000 emails"
            }
          ]
        },
        "value_schema": [
          {
            "field": "name",
            "type": "string",
            "label": "Product name (the only required field)"
          },
          {
            "field": "website_url",
            "type": "string",
            "label": "Marketing website URL"
          },
          {
            "field": "vendor_name",
            "type": "string",
            "label": "Company/vendor name behind the product"
          },
          {
            "field": "vendor_description",
            "type": "string",
            "label": "One-line description, quoted from the vendor"
          },
          {
            "field": "categories",
            "type": "string[]",
            "label": "Category/leaf slugs it belongs to, e.g. [\"email\",\"sms\"]"
          },
          {
            "field": "primary_use_cases",
            "type": "string[]",
            "label": "What it's used for"
          },
          {
            "field": "supported_actions",
            "type": "string[]",
            "label": "Concrete API actions/capabilities"
          },
          {
            "field": "supported_regions",
            "type": "string[]",
            "label": "Countries/regions/data-residency"
          },
          {
            "field": "supported_languages",
            "type": "string[]",
            "label": "Human/spoken languages supported"
          },
          {
            "field": "input_types",
            "type": "string[]",
            "label": "Accepted input types/formats"
          },
          {
            "field": "output_types",
            "type": "string[]",
            "label": "Produced output types/formats"
          },
          {
            "field": "webhooks_supported",
            "type": "bool",
            "label": "Supports webhooks?"
          },
          {
            "field": "sandbox_available",
            "type": "bool",
            "label": "Dedicated sandbox/test mode?"
          },
          {
            "field": "sdk_languages",
            "type": "string[]",
            "label": "Languages with an official SDK"
          },
          {
            "field": "mcp_server_available",
            "type": "bool",
            "label": "Official MCP server?"
          },
          {
            "field": "pricing_model",
            "type": "enum",
            "label": "Pricing model",
            "values": [
              "usage_based",
              "subscription",
              "seat_based",
              "hybrid",
              "contact_sales"
            ]
          },
          {
            "field": "has_published_pricing",
            "type": "bool",
            "label": "Concrete prices published publicly?"
          },
          {
            "field": "free_tier_available",
            "type": "bool",
            "label": "Recurring/perpetual free tier (not a trial)?"
          },
          {
            "field": "free_tier_details",
            "type": "string",
            "label": "What the free tier includes"
          },
          {
            "field": "minimum_commitment",
            "type": "string",
            "label": "Any stated minimum spend/commitment"
          },
          {
            "field": "self_serve_signup",
            "type": "bool",
            "label": "Get an API key without talking to sales?"
          },
          {
            "field": "requires_sales_call",
            "type": "bool",
            "label": "Does going live require sales?"
          },
          {
            "field": "enterprise_plan_available",
            "type": "bool",
            "label": "Named enterprise tier?"
          },
          {
            "field": "starting_price_usd",
            "type": "number",
            "label": "Lowest published paid entry price (USD number)"
          },
          {
            "field": "price_basis",
            "type": "string",
            "label": "Unit the starting price is per, e.g. '1,000 emails'"
          },
          {
            "field": "free_tier_limit",
            "type": "string",
            "label": "Free-tier ceiling in literal terms"
          },
          {
            "field": "price_points",
            "type": "object[]",
            "label": "Structured prices: [{plan,item,amount_usd,amount_percent,per,source_url}]"
          },
          {
            "field": "soc2",
            "type": "enum",
            "label": "SOC 2 status",
            "values": [
              "type_2",
              "type_1",
              "in_progress",
              "none",
              "unknown"
            ]
          },
          {
            "field": "hipaa",
            "type": "bool",
            "label": "HIPAA (e.g. BAA available)?"
          },
          {
            "field": "gdpr",
            "type": "bool",
            "label": "GDPR compliance stated?"
          },
          {
            "field": "iso_27001",
            "type": "bool",
            "label": "ISO 27001 certified?"
          },
          {
            "field": "pci_dss",
            "type": "bool",
            "label": "PCI DSS compliant?"
          },
          {
            "field": "sla_published",
            "type": "bool",
            "label": "Published SLA / uptime commitment?"
          },
          {
            "field": "documented_rate_limits",
            "type": "string",
            "label": "Documented rate limits, quoted"
          },
          {
            "field": "known_restrictions",
            "type": "string[]",
            "label": "Notable documented restrictions/limits"
          },
          {
            "field": "auth_methods",
            "type": "string[]",
            "label": "Auth methods",
            "values": [
              "api_key",
              "oauth2",
              "jwt",
              "basic",
              "hmac_signature",
              "mtls",
              "session"
            ]
          },
          {
            "field": "api_style",
            "type": "enum",
            "label": "Primary API style",
            "values": [
              "rest",
              "graphql",
              "grpc",
              "soap",
              "websocket"
            ]
          },
          {
            "field": "base_url",
            "type": "string",
            "label": "API root/base URL"
          },
          {
            "field": "api_version",
            "type": "string",
            "label": "Current API version string"
          },
          {
            "field": "quickstart_url",
            "type": "string",
            "label": "Quickstart / hello-world URL"
          },
          {
            "field": "docs_url",
            "type": "string",
            "label": "Developer docs URL"
          },
          {
            "field": "api_reference_url",
            "type": "string",
            "label": "API reference URL"
          },
          {
            "field": "openapi_spec_url",
            "type": "string",
            "label": "OpenAPI spec URL"
          },
          {
            "field": "changelog_url",
            "type": "string",
            "label": "Changelog URL"
          },
          {
            "field": "status_page_url",
            "type": "string",
            "label": "Status page URL"
          },
          {
            "field": "notable_customers",
            "type": "string[]",
            "label": "Named public customers"
          },
          {
            "field": "launched_at",
            "type": "string",
            "label": "Launch date (ISO date or year)"
          }
        ]
      },
      {
        "action": "token",
        "label": "Optional - raise your rate limit",
        "method": "GET",
        "url": "https://apio.sh/api/feedback/token"
      }
    ]
  }
}