ZuploZuplo
LoginStart for Free
  • Documentation
  • API Reference
Introduction
Getting Started
    Develop using the Portal
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth4 - Deploy5 - Dynamic Rate LimitingMCP - Quick start
    Develop Locally
      1 - Setup Your Gateway2 - Rate Limiting3 - API Key Auth
Concepts
Development
Policies
Handlers
    URL ForwardURL RewriteFunction HandlerAWS LambdaMCP ServerRedirectOpenAPI Spec HandlerInternal Route HandlersWebSocket Handler
API Keys
MCP Server
MCP Gateway
AI Gateway
Developer Portal
Monetization
Deploying & Source Control
Observability
Networking & Infrastructure
Account Management
Programming API
Build with AI
Zuplo CLI
Migration Guides
Platform LimitsSecuritySupportTrust & ComplianceChangelog
powered by Zudoku
Handlers

Internal Route Handlers

The Zuplo Runtime automatically registers certain routes on your gateway to provide enhanced functionality. Requests to these routes may appear in your Analytics page. Below is a list of reserved routes:

NameMethodPathDescription
cors-preflightOPTIONS/(.*)Handles CORS preflight requests.
developer-portalGETUser configured, default: /docsHandles serving the legacy Developer Portal.
developer-portal-legacyGET/__zuplo/dev-portalLegacy path for the Developer Portal.
pingGET/__zuplo/pingUsed to check liveness of deployments.
unmatched-pathAll/(.*)Handles requests to endpoints that haven't been configured.

Behavior Details

cors-preflight

This handler automatically responds to CORS preflight (OPTIONS) requests based on the CORS policy configured for each route. It runs before any user-defined route handlers.

ping

The /__zuplo/ping endpoint returns a simple response that indicates the deployment is live and accepting requests. Use this endpoint for health checks and uptime monitoring.

unmatched-path

When a request does not match any configured route, this handler returns a 404 Not Found response. It acts as a catch-all for undefined paths.

Internal routes are reserved by the Zuplo runtime.

Edit this page
Last modified on March 23, 2026
OpenAPI Spec HandlerWebSocket Handler
On this page
  • Behavior Details
    • cors-preflight
    • ping
    • unmatched-path