For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Redirects

Return a redirect response that rewrites the scheme, host, path, or status code before a request reaches any backend.

Attaches to:

Request redirectsRedirectA traffic management feature that sends clients to a different URL, with configurable scheme, authority, path, or status code. allow returning a direct response redirecting users to another location.

For example, the following configuration will return a 307 Temporary Redirect response with the header location: https://example.com/new-path:

# yaml-language-server: $schema=https://agentgateway.dev/schema/config
mcp:
  port: 3000
  policies:
    requestRedirect:
      scheme: https
      authority:
        full: example.com
      path:
        full: /new-path
      status: 307
  targets:
  - name: everything
    stdio:
      cmd: npx
      args: ["@modelcontextprotocol/server-everything"]

# yaml-language-server: $schema=https://agentgateway.dev/schema/config
gateways:
  default:
    port: 3000
routes:
- policies:
    requestRedirect:
      scheme: https
      authority:
        full: example.com
      path:
        full: /new-path
      status: 307