Kgateway Kubernetes Gateway API

openapi: 3.1.0
info:
  title: kgateway Kubernetes Gateway API
  description: >-
    kgateway is the most widely deployed gateway in Kubernetes for microservices
    and AI agents. It is a feature-rich, fast, and flexible Kubernetes-native
    ingress controller and next-generation API gateway built on top of Envoy
    proxy and the Kubernetes Gateway API. kgateway provides custom resource
    definitions (CRDs) under the gateway.kgateway.dev API group for configuring
    traffic policies, backends, direct responses, gateway extensions, gateway
    parameters, HTTP listener policies, and AI backends. These resources are
    managed through the Kubernetes API server.
  version: 2.1.0
  contact:
    name: kgateway
    url: https://kgateway.dev
  license:
    name: Apache 2.0
    url: https://github.com/kgateway-dev/kgateway/blob/main/LICENSE
externalDocs:
  description: kgateway API Reference Documentation
  url: https://kgateway.dev/docs/envoy/latest/reference/api/
servers:
  - url: https://{kubernetes-api-server}/apis/gateway.kgateway.dev/v1alpha1
    description: Kubernetes API Server - kgateway Custom Resources
    variables:
      kubernetes-api-server:
        default: kubernetes.default.svc
        description: The Kubernetes API server hostname
tags:
  - name: AIBackend
    description: >-
      Configure AI backend providers with support for LLM providers such as
      OpenAI, Azure OpenAI, and Gemini. Specify provider configuration and
      priority groups for AI routing.
  - name: Backend
    description: >-
      Define routable backends such as AI providers (OpenAI, Azure, Gemini),
      AWS Lambda functions, or static servers for use by Gateways. Reference
      Backend resources in HTTPRoute to route traffic to external services.
  - name: DirectResponse
    description: >-
      Configure Gateways to directly respond to incoming requests with a custom
      HTTP response code and body without forwarding to a backend service.
  - name: GatewayExtension
    description: >-
      Integrate external services with a Gateway such as external auth, rate
      limiting, and external processing. Serves as a configuration bridge
      between kgateway and external services that extend Gateway functionality.
  - name: GatewayParameters
    description: >-
      Customize gateway infrastructure deployment settings including replicas,
      container configuration, pod templates, and proxy provisioning parameters.
  - name: HTTPListenerPolicy
    description: >-
      Apply policies to all HTTP and HTTPS listeners defined on a Gateway.
      Configure listener-level settings that affect all traffic passing through
      the specified listeners.
  - name: TrafficPolicy
    description: >-
      Attach traffic management policies to routes in an HTTPRoute resource or
      all routes served by a Gateway. Supports CORS, external auth, external
      processing, rate limiting, timeouts, retries, transformations, and header
      modifiers.
paths:
  /namespaces/{namespace}/trafficpolicies:
    get:
      operationId: listTrafficPolicies
      summary: Kgateway List TrafficPolicy resources
      description: List all TrafficPolicy resources in the specified namespace.
      tags:
        - TrafficPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of TrafficPolicy resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrafficPolicyList'
        '401':
          description: Unauthorized
    post:
      operationId: createTrafficPolicy
      summary: Kgateway Create a TrafficPolicy
      description: >-
        Create a TrafficPolicy resource to attach traffic management policies to
        routes in an HTTPRoute resource.
      tags:
        - TrafficPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrafficPolicy'
      responses:
        '201':
          description: Successfully created TrafficPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrafficPolicy'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/trafficpolicies/{name}:
    get:
      operationId: getTrafficPolicy
      summary: Kgateway Get a TrafficPolicy
      description: Retrieve a specific TrafficPolicy resource by name and namespace.
      tags:
        - TrafficPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved TrafficPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrafficPolicy'
        '401':
          description: Unauthorized
        '404':
          description: TrafficPolicy not found
    put:
      operationId: replaceTrafficPolicy
      summary: Kgateway Replace a TrafficPolicy
      description: Replace a specific TrafficPolicy resource.
      tags:
        - TrafficPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TrafficPolicy'
      responses:
        '200':
          description: Successfully replaced TrafficPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TrafficPolicy'
        '401':
          description: Unauthorized
        '404':
          description: TrafficPolicy not found
    delete:
      operationId: deleteTrafficPolicy
      summary: Kgateway Delete a TrafficPolicy
      description: Delete a specific TrafficPolicy resource.
      tags:
        - TrafficPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted TrafficPolicy.
        '401':
          description: Unauthorized
        '404':
          description: TrafficPolicy not found
  /namespaces/{namespace}/backends:
    get:
      operationId: listBackends
      summary: Kgateway List Backend resources
      description: >-
        List all Backend resources in the specified namespace. Backends define
        routable external services such as AI providers, AWS Lambda functions,
        or static servers.
      tags:
        - Backend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of Backend resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendList'
        '401':
          description: Unauthorized
    post:
      operationId: createBackend
      summary: Kgateway Create a Backend
      description: >-
        Create a Backend resource to define a routable backend such as an AI
        provider, AWS Lambda function, or static server.
      tags:
        - Backend
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Backend'
      responses:
        '201':
          description: Successfully created Backend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Backend'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/backends/{name}:
    get:
      operationId: getBackend
      summary: Kgateway Get a Backend
      description: Retrieve a specific Backend resource by name and namespace.
      tags:
        - Backend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved Backend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Backend'
        '401':
          description: Unauthorized
        '404':
          description: Backend not found
    put:
      operationId: replaceBackend
      summary: Kgateway Replace a Backend
      description: Replace a specific Backend resource.
      tags:
        - Backend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/Backend'
      responses:
        '200':
          description: Successfully replaced Backend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Backend'
        '401':
          description: Unauthorized
        '404':
          description: Backend not found
    delete:
      operationId: deleteBackend
      summary: Kgateway Delete a Backend
      description: Delete a specific Backend resource.
      tags:
        - Backend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted Backend.
        '401':
          description: Unauthorized
        '404':
          description: Backend not found
  /namespaces/{namespace}/directresponses:
    get:
      operationId: listDirectResponses
      summary: Kgateway List DirectResponse resources
      description: >-
        List all DirectResponse resources in the specified namespace.
        DirectResponse resources allow Gateways to directly respond to requests
        with custom HTTP response codes and bodies.
      tags:
        - DirectResponse
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of DirectResponse resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectResponseList'
        '401':
          description: Unauthorized
    post:
      operationId: createDirectResponse
      summary: Kgateway Create a DirectResponse
      description: >-
        Create a DirectResponse resource to configure a Gateway to directly
        respond to incoming requests with a custom HTTP response.
      tags:
        - DirectResponse
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectResponse'
      responses:
        '201':
          description: Successfully created DirectResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectResponse'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/directresponses/{name}:
    get:
      operationId: getDirectResponse
      summary: Kgateway Get a DirectResponse
      description: Retrieve a specific DirectResponse resource by name and namespace.
      tags:
        - DirectResponse
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved DirectResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectResponse'
        '401':
          description: Unauthorized
        '404':
          description: DirectResponse not found
    put:
      operationId: replaceDirectResponse
      summary: Kgateway Replace a DirectResponse
      description: Replace a specific DirectResponse resource.
      tags:
        - DirectResponse
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DirectResponse'
      responses:
        '200':
          description: Successfully replaced DirectResponse.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DirectResponse'
        '401':
          description: Unauthorized
        '404':
          description: DirectResponse not found
    delete:
      operationId: deleteDirectResponse
      summary: Kgateway Delete a DirectResponse
      description: Delete a specific DirectResponse resource.
      tags:
        - DirectResponse
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted DirectResponse.
        '401':
          description: Unauthorized
        '404':
          description: DirectResponse not found
  /namespaces/{namespace}/gatewayextensions:
    get:
      operationId: listGatewayExtensions
      summary: Kgateway List GatewayExtension resources
      description: >-
        List all GatewayExtension resources in the specified namespace.
        GatewayExtensions integrate external services with a Gateway.
      tags:
        - GatewayExtension
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of GatewayExtension resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayExtensionList'
        '401':
          description: Unauthorized
    post:
      operationId: createGatewayExtension
      summary: Kgateway Create a GatewayExtension
      description: >-
        Create a GatewayExtension resource to integrate external services such
        as external auth, rate limiting, or external processing with a Gateway.
      tags:
        - GatewayExtension
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GatewayExtension'
      responses:
        '201':
          description: Successfully created GatewayExtension.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayExtension'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/gatewayextensions/{name}:
    get:
      operationId: getGatewayExtension
      summary: Kgateway Get a GatewayExtension
      description: Retrieve a specific GatewayExtension resource by name and namespace.
      tags:
        - GatewayExtension
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved GatewayExtension.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayExtension'
        '401':
          description: Unauthorized
        '404':
          description: GatewayExtension not found
    put:
      operationId: replaceGatewayExtension
      summary: Kgateway Replace a GatewayExtension
      description: Replace a specific GatewayExtension resource.
      tags:
        - GatewayExtension
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GatewayExtension'
      responses:
        '200':
          description: Successfully replaced GatewayExtension.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayExtension'
        '401':
          description: Unauthorized
        '404':
          description: GatewayExtension not found
    delete:
      operationId: deleteGatewayExtension
      summary: Kgateway Delete a GatewayExtension
      description: Delete a specific GatewayExtension resource.
      tags:
        - GatewayExtension
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted GatewayExtension.
        '401':
          description: Unauthorized
        '404':
          description: GatewayExtension not found
  /namespaces/{namespace}/gatewayparameters:
    get:
      operationId: listGatewayParameters
      summary: Kgateway List GatewayParameters resources
      description: >-
        List all GatewayParameters resources in the specified namespace.
        GatewayParameters customize gateway infrastructure deployment settings.
      tags:
        - GatewayParameters
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of GatewayParameters resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayParametersList'
        '401':
          description: Unauthorized
    post:
      operationId: createGatewayParameters
      summary: Kgateway Create GatewayParameters
      description: >-
        Create a GatewayParameters resource to customize gateway infrastructure
        deployment settings including replicas, container configuration, and
        proxy provisioning parameters.
      tags:
        - GatewayParameters
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GatewayParameters'
      responses:
        '201':
          description: Successfully created GatewayParameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayParameters'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/gatewayparameters/{name}:
    get:
      operationId: getGatewayParameters
      summary: Kgateway Get GatewayParameters
      description: Retrieve a specific GatewayParameters resource by name and namespace.
      tags:
        - GatewayParameters
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved GatewayParameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayParameters'
        '401':
          description: Unauthorized
        '404':
          description: GatewayParameters not found
    put:
      operationId: replaceGatewayParameters
      summary: Kgateway Replace GatewayParameters
      description: Replace a specific GatewayParameters resource.
      tags:
        - GatewayParameters
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GatewayParameters'
      responses:
        '200':
          description: Successfully replaced GatewayParameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GatewayParameters'
        '401':
          description: Unauthorized
        '404':
          description: GatewayParameters not found
    delete:
      operationId: deleteGatewayParameters
      summary: Kgateway Delete GatewayParameters
      description: Delete a specific GatewayParameters resource.
      tags:
        - GatewayParameters
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted GatewayParameters.
        '401':
          description: Unauthorized
        '404':
          description: GatewayParameters not found
  /namespaces/{namespace}/httplistenerpolicies:
    get:
      operationId: listHTTPListenerPolicies
      summary: Kgateway List HTTPListenerPolicy resources
      description: >-
        List all HTTPListenerPolicy resources in the specified namespace.
        HTTPListenerPolicies apply policies to all HTTP and HTTPS listeners on
        a Gateway.
      tags:
        - HTTPListenerPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of HTTPListenerPolicy resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPListenerPolicyList'
        '401':
          description: Unauthorized
    post:
      operationId: createHTTPListenerPolicy
      summary: Kgateway Create an HTTPListenerPolicy
      description: >-
        Create an HTTPListenerPolicy resource to apply policies to all HTTP and
        HTTPS listeners defined on a Gateway.
      tags:
        - HTTPListenerPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HTTPListenerPolicy'
      responses:
        '201':
          description: Successfully created HTTPListenerPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPListenerPolicy'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/httplistenerpolicies/{name}:
    get:
      operationId: getHTTPListenerPolicy
      summary: Kgateway Get an HTTPListenerPolicy
      description: >-
        Retrieve a specific HTTPListenerPolicy resource by name and namespace.
      tags:
        - HTTPListenerPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved HTTPListenerPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPListenerPolicy'
        '401':
          description: Unauthorized
        '404':
          description: HTTPListenerPolicy not found
    put:
      operationId: replaceHTTPListenerPolicy
      summary: Kgateway Replace an HTTPListenerPolicy
      description: Replace a specific HTTPListenerPolicy resource.
      tags:
        - HTTPListenerPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HTTPListenerPolicy'
      responses:
        '200':
          description: Successfully replaced HTTPListenerPolicy.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPListenerPolicy'
        '401':
          description: Unauthorized
        '404':
          description: HTTPListenerPolicy not found
    delete:
      operationId: deleteHTTPListenerPolicy
      summary: Kgateway Delete an HTTPListenerPolicy
      description: Delete a specific HTTPListenerPolicy resource.
      tags:
        - HTTPListenerPolicy
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted HTTPListenerPolicy.
        '401':
          description: Unauthorized
        '404':
          description: HTTPListenerPolicy not found
  /namespaces/{namespace}/aibackends:
    get:
      operationId: listAIBackends
      summary: Kgateway List AIBackend resources
      description: >-
        List all AIBackend resources in the specified namespace. AIBackends
        configure AI provider backends such as OpenAI, Azure OpenAI, and
        Gemini for AI gateway routing.
      tags:
        - AIBackend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/LabelSelector'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Continue'
      responses:
        '200':
          description: Successfully retrieved list of AIBackend resources.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AIBackendList'
        '401':
          description: Unauthorized
    post:
      operationId: createAIBackend
      summary: Kgateway Create an AIBackend
      description: >-
        Create an AIBackend resource to configure an AI provider backend with
        LLM provider settings and priority groups.
      tags:
        - AIBackend
      parameters:
        - $ref: '#/components/parameters/Namespace'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AIBackend'
      responses:
        '201':
          description: Successfully created AIBackend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AIBackend'
        '401':
          description: Unauthorized
        '409':
          description: Conflict - resource already exists
  /namespaces/{namespace}/aibackends/{name}:
    get:
      operationId: getAIBackend
      summary: Kgateway Get an AIBackend
      description: Retrieve a specific AIBackend resource by name and namespace.
      tags:
        - AIBackend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully retrieved AIBackend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AIBackend'
        '401':
          description: Unauthorized
        '404':
          description: AIBackend not found
    put:
      operationId: replaceAIBackend
      summary: Kgateway Replace an AIBackend
      description: Replace a specific AIBackend resource.
      tags:
        - AIBackend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AIBackend'
      responses:
        '200':
          description: Successfully replaced AIBackend.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AIBackend'
        '401':
          description: Unauthorized
        '404':
          description: AIBackend not found
    delete:
      operationId: deleteAIBackend
      summary: Kgateway Delete an AIBackend
      description: Delete a specific AIBackend resource.
      tags:
        - AIBackend
      parameters:
        - $ref: '#/components/parameters/Namespace'
        - $ref: '#/components/parameters/Name'
      responses:
        '200':
          description: Successfully deleted AIBackend.
        '401':
          description: Unauthorized
        '404':
          description: AIBackend not found
components:
  parameters:
    Namespace:
      name: namespace
      in: path
      required: true
      description: The Kubernetes namespace.
      schema:
        type: string
    Name:
      name: name
      in: path
      required: true
      description: The name of the resource.
      schema:
        type: string
    LabelSelector:
      name: labelSelector
      in: query
      required: false
      description: A selector to restrict the list of returned objects by labels.
      schema:
        type: string
    Limit:
      name: limit
      in: query
      required: false
      description: Maximum number of resources to return.
      schema:
        type: integer
    Continue:
      name: continue
      in: query
      required: false
      description: Continue token for paginated list requests.
      schema:
        type: string
  schemas:
    ObjectMeta:
      type: object
      description: Standard Kubernetes object metadata.
      properties:
        name:
          type: string
          description: Name of the resource.
        namespace:
          type: string
          description: Namespace of the resource.
        labels:
          type: object
          additionalProperties:
            type: string
          description: Map of string keys and values for organizing resources.
        annotations:
          type: object
          additionalProperties:
            type: string
          description: Annotations for storing arbitrary metadata.
        resourceVersion:
          type: string
          description: >-
            An opaque value that represents the internal version of this object.
        creationTimestamp:
          type: string
          format: date-time
          description: Timestamp representing the server time when this object was created.
    PolicyTargetRef:
      type: object
      description: Reference to a target resource for policy attachment.
      properties:
        group:
          type: string
          description: Group is the group of the target resource.
          default: gateway.networking.k8s.io
        kind:
          type: string
          description: Kind is the kind of the target resource.
          enum:
            - Gateway
            - HTTPRoute
        name:
          type: string
          description: Name is the name of the target resource.
        namespace:
          type: string
          description: Namespace is the namespace of the target resource.
        sectionName:
          type: string
          description: >-
            SectionName is the name of a section within the target resource
            to apply the policy to.
      required:
        - kind
        - name
    TrafficPolicy:
      type: object
      description: >-
        TrafficPolicy attaches traffic management policies to routes in an
        HTTPRoute or all routes served by a Gateway.
      properties:
        apiVersion:
          type: string
          enum:
            - gateway.kgateway.dev/v1alpha1
        kind:
          type: string
          enum:
            - TrafficPolicy
 

# --- truncated at 32 KB (62 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kgateway/refs/heads/main/openapi/kgateway-kubernetes-gateway-api-openapi.yml