Envoy

Envoy Runtime API

Runtime settings management endpoints

GitHub OpenAPI

Operations 2

GET /runtime Envoy Get runtime settings #
POST /runtime_modify Envoy Modify runtime settings #

Documentation

📖
Documentation
https://www.envoyproxy.io/docs/envoy/latest/operations/admin
📖
Documentation
https://aigateway.envoyproxy.io/docs/
📖
GettingStarted
https://aigateway.envoyproxy.io/docs/getting-started/basic-usage/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/envoy/refs/heads/main/openapi/envoy-runtime-api-openapi.yml

SDKs

📦
GitHubRepository
https://github.com/envoyproxy/ai-gateway

Other Resources

🔗
Reference
https://aigateway.envoyproxy.io/docs/api/
🔗
ChangeLog
https://aigateway.envoyproxy.io/release-notes/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/envoy-runtime-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

envoy-runtime-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Envoy Admin Runtime API
  description: The Envoy Admin API provides local administrative access to a running Envoy proxy instance. It exposes endpoints for inspecting configuration, checking health, viewing statistics, managing log levels, and controlling the runtime state of the proxy. The Admin API is typically bound to a local interface (default port 9901) and is not intended for external exposure in production environments.
  version: 1.31.0
  contact:
    name: Envoy Proxy Community
    url: https://www.envoyproxy.io/community
  termsOfService: https://www.envoyproxy.io/
servers:
- url: http://localhost:9901
  description: Default Envoy Admin Interface
tags:
- name: Runtime
  description: Runtime settings management endpoints
paths:
  /runtime:
    get:
      operationId: getRuntime
      summary: Envoy Get runtime settings
      description: Returns the current runtime settings showing all layers, their configured values, and the final merged value for each key. Runtime values control various Envoy behaviors without requiring a restart.
      tags:
      - Runtime
      responses:
        '200':
          description: Runtime settings retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RuntimeResponse'
  /runtime_modify:
    post:
      operationId: modifyRuntime
      summary: Envoy Modify runtime settings
      description: Adds or modifies runtime values in the admin overriding layer. Values are passed as query parameters where the key is the runtime feature flag name and the value is the new setting. Use the value - (dash) to remove a previously set override.
      tags:
      - Runtime
      responses:
        '200':
          description: Runtime settings modified successfully
          content:
            text/plain:
              schema:
                type: string
        '400':
          description: Invalid runtime key or value specified
          content:
            text/plain:
              schema:
                type: string
components:
  schemas:
    RuntimeResponse:
      type: object
      description: Runtime settings showing all layers and merged values
      properties:
        layers:
          type: array
          description: Ordered list of runtime layer names
          items:
            type: string
        entries:
          type: object
          description: Map of runtime key to merged and per-layer values
          additionalProperties:
            type: object
            properties:
              final_value:
                type: string
                description: The final merged value after applying all layers
              layer_values:
                type: array
                description: Values from each layer in order
                items:
                  type: string
externalDocs:
  description: Envoy Admin Interface Documentation
  url: https://www.envoyproxy.io/docs/envoy/latest/operations/admin