This page is also available as Markdown: request this page's URL with an Accept: text/markdown header. For an index of Next.js Pages Router documentation, see /docs/pages/llms.txt.

You are currently viewing the documentation for Pages Router.

Runtime Integration

Last updated July 29, 2026

The Deployment Adapter API is a build-time interface. It tells your platform what was built and how to route requests. Runtime behavior (request handling, streaming, caching) is handled by the Next.js server itself and by the cache interfaces cacheHandler and cacheHandlers.

Together, the adapter and cache interfaces form the complete platform integration surface:

Adapter (build-time): processes build outputs, configures routing, and sets up platform-specific infrastructure.
Cache Interfaces (runtime): cacheHandler manages ISR/server cache storage and revalidation across instances; cacheHandlers configures 'use cache' directive backends and tag coordination.

Handler Context

When invoking entrypoints, adapters pass a ctx object to the Next.js handler. Key fields include:

ctx.waitUntil: a function that accepts a promise. Use this to keep the serverless function alive after the response is sent, allowing background work like cache revalidation to complete.
requestMeta.onCacheEntryV2 (set via addRequestMeta): a callback that fires when a cache entry is generated or looked up. Use this to observe all cache operations (not just PPR) and propagate cache updates to your platform's storage backend. This callback fires on the instance that handled the request. For multi-instance deployments, your adapter should propagate updates to shared storage. See How Revalidation Works for coordination patterns.