---
title: "Query API Requests"
url: "https://nov18-dev.movespot.fyi/apis/konnect-api-request-analytics-2/versions/df5e182e-3b27-4baf-b6d7-0b0a459c9f64/operations/query-requests"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-api-request-analytics-2/versions/df5e182e-3b27-4baf-b6d7-0b0a459c9f64.md

# Query API Requests

`POST` `/api-requests`

Operation ID: `query-requests`

Returns API requests that were proxied through the Kong Gateway.

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Response from the Analytics Requests API.
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden

## OpenAPI definition

```yaml
openapi: 3.0.2
info:
  title: Konnect API Request Analytics
  version: 2.0.0
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
paths:
  /api-requests:
    post:
      operationId: query-requests
      summary: Query API Requests
      description: Returns API requests that were proxied through the Kong Gateway.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/AnalyticsRequestsQuery"
            examples:
              Example multiselect filters:
                $ref: "#/components/examples/ExampleMultiselectFilters"
              Example single select filters:
                $ref: "#/components/examples/ExampleSingleSelectFilters"
              Example numeric filters:
                $ref: "#/components/examples/ExampleNumericFilters"
              Example wildcard filters:
                $ref: "#/components/examples/ExampleWildcardFilters"
              Example empty filters:
                $ref: "#/components/examples/ExampleEmptyFilters"
              Example pagination and absolute time range:
                $ref: "#/components/examples/ExampleAbsoluteTimeRangeAndPagination"
      responses:
        "200":
          $ref: "#/components/responses/AnalyticsRequestsResponse"
        "400":
          description: Bad Request
          content:
            application/problem+json:
              examples:
                BadRequestExample:
                  $ref: "#/components/examples/BadRequestExample"
        "401":
          $ref: "#/components/responses/Unauthorized"
        "403":
          $ref: "#/components/responses/Forbidden"
      tags:
        - API Requests
security:
  - personalAccessToken: []
components:
  schemas:
    AnalyticsRequestsQuery:
      oneOf:
        - $ref: "#/components/schemas/AnalyticsRequestsFilterByFieldQuery"
        - $ref: "#/components/schemas/AnalyticsRequestsFilterByDimensionQuery"
    AnalyticsRequestsFilterByFieldQuery:
      type: object
      properties:
        filters:
          type: array
          items:
            oneOf:
              - $ref: "#/components/schemas/A2aContextIdFilterByField"
              - $ref: "#/components/schemas/A2aErrorFilterByField"
              - $ref: "#/components/schemas/A2aMethodFilterByField"
              - $ref: "#/components/schemas/A2aTaskIdFilterByField"
              - $ref: "#/components/schemas/ApiFilterByField"
              - $ref: "#/components/schemas/ApiPackageFilterByField"
              - $ref: "#/components/schemas/ApiProductFilterByField"
              - $ref: "#/components/schemas/ApiProductVersionFilterByField"
              - $ref: "#/components/schemas/ApplicationFilterByField"
              - $ref: "#/components/schemas/AuthTypeFilterByField"
              - $ref: "#/components/schemas/ClientIpFilterByField"
              - $ref: "#/components/schemas/ConsumerFilterByField"
              - $ref: "#/components/schemas/ControlPlaneFilterByField"
              - $ref: "#/components/schemas/ControlPlaneGroupFilterByField"
              - $ref: "#/components/schemas/CountryCodeFilterByField"
              - $ref: "#/components/schemas/DataPlaneNodeFilterByField"
              - $ref: "#/components/schemas/DataPlaneNodeVersionFilterByField"
              - $ref: "#/components/schemas/GatewayServiceFilterByField"
              - $ref: "#/components/schemas/HeaderHostFilterByField"
              - $ref: "#/components/schemas/HeaderUserAgentFilterByField"
              - $ref: "#/components/schemas/HttpMethodFilterByField"
              - $ref: "#/components/schemas/LatenciesKongGatewayMsFilterByField"
              - $ref: "#/components/schemas/LatenciesResponseMsFilterByField"
              - $ref: "#/components/schemas/LatenciesUpstreamMsFilterByField"
              - $ref: "#/components/schemas/McpErrorFilterByField"
              - $ref: "#/components/schemas/McpMethodFilterByField"
              - $ref: "#/components/schemas/McpSessionIdFilterByField"
              - $ref: "#/components/schemas/McpToolNameFilterByField"
              - $ref: "#/components/schemas/PortalFilterByField"
              - $ref: "#/components/schemas/RealmFilterByField"
              - $ref: "#/components/schemas/ResponseBodySizeFilterByField"
              - $ref: "#/components/schemas/ResponseHeaderContentLengthFilterByField"
              - $ref: "#/components/schemas/ResponseSourceFilterByField"
              - $ref: "#/components/schemas/RequestBodySizeFilterByField"
              - $ref: "#/components/schemas/RequestIdFilterByField"
              - $ref: "#/components/schemas/RequestUriFilterByField"
              - $ref: "#/components/schemas/ResponseHeaderContentTypeFilterByField"
              - $ref: "#/components/schemas/RouteFilterByField"
              - $ref: "#/components/schemas/ServicePortFilterByField"
              - $ref: "#/components/schemas/ServiceProtocolFilterByField"
              - $ref: "#/components/schemas/StatusCodeFilterByField"
              - $ref: "#/components/schemas/StatusCodeGroupedFilterByField"
              - $ref: "#/components/schemas/TraceIdFilterByField"
              - $ref: "#/components/schemas/UpstreamStatusCodeFilterByField"
              - $ref: "#/components/schemas/UpstreamStatusCodeGroupedFilterByField"
              - $ref: "#/components/schemas/UpstreamUriFilterByField"
          default: []
        time_range:
          $ref: "#/components/schemas/FilterTimeRange"
        order:
          $ref: "#/components/schemas/FilterOrder"
        size:
          $ref: "#/components/schemas/FilterSize"
        offset:
          $ref: "#/components/schemas/FilterOffset"
      additionalProperties: false
      title: Filter by field
    AnalyticsRequestsFilterByDimensionQuery:
      type: object
      properties:
        filters:
          type: array
          items:
            oneOf:
              - $ref: "#/components/schemas/ApiProductFilterByDimension"
              - $ref: "#/components/schemas/ApiProductVersionFilterByDimension"
              - $ref: "#/components/schemas/ApplicationFilterByDimension"
              - $ref: "#/components/schemas/ConsumerFilterByDimension"
              - $ref: "#/components/schemas/ControlPlaneFilterByDimension"
              - $ref: "#/components/schemas/ControlPlaneGroupFilterByDimension"
              - $ref: "#/components/schemas/DataPlaneNodeFilterByDimension"
              - $ref: "#/components/schemas/GatewayServiceFilterByDimension"
              - $ref: "#/components/schemas/RouteFilterByDimension"
              - $ref: "#/components/schemas/StatusCodeFilterByDimension"
              - $ref: "#/components/schemas/StatusCodeGroupedFilterByDimension"
          default: []
        time_range:
          $ref: "#/components/schemas/FilterTimeRange"
        order:
          $ref: "#/components/schemas/FilterOrder"
        size:
          $ref: "#/components/schemas/FilterSize"
        offset:
          $ref: "#/components/schemas/FilterOffset"
      additionalProperties: false
      deprecated: true
      title: Filter by dimension
    ResponseResults:
      description: Mapping of the columns to values.
      type: array
      items:
        type: object
        additionalProperties: false
        properties:
          request_start:
            description: The time the gateway started processing the request.
            type: string
          a2a_info:
            description: A2A protocol information associated with the request, including
              task call details.
            type: object
            nullable: true
            properties:
              rpc:
                description: Array of A2A RPC calls made during the request.
                type: array
                items:
                  type: object
                  properties:
                    id:
                      description: Unique identifier for the RPC call.
                      type: string
                      nullable: true
                    method:
                      description: The A2A method called.
                      type: string
                      nullable: true
                    context_id:
                      description: Context identifier for the A2A session.
                      type: string
                      nullable: true
                    task_id:
                      description: Unique identifier for the A2A task.
                      type: string
                      nullable: true
                    task_state:
                      description: State of the A2A task.
                      type: string
                      nullable: true
                    latency:
                      description: Latency of the RPC call in milliseconds.
                      type: integer
                      nullable: true
                    response_body_size:
                      description: Size of the RPC response body in bytes.
                      type: integer
                      nullable: true
                    error:
                      description: Error message from the RPC call, if any.
                      type: string
                      nullable: true
          api:
            description: API ID associated with the request.
            type: string
            nullable: true
          api_package:
            description: API Package ID associated with the request.
            type: string
            nullable: true
          api_product:
            description: API Product ID associated with the request.
            type: string
            nullable: true
          api_product_version:
            description: API Product Version ID associated with the request.
            type: string
            nullable: true
          application:
            description: Application ID associated with the request.
            type: string
            nullable: true
          auth_type:
            description: Type of authorization plugin associated with the request. Values
              are `key-auth` or `openid-connect`.
            type: string
            nullable: true
          client_ip:
            description: Client IP associated with the request.
            type: string
            nullable: true
          consumer:
            description: Consumer ID associated with the request. In the format
              `control_plane_id:consumer_id`.
            type: string
            nullable: true
          control_plane:
            description: Control Plane ID associated with the request.
            type: string
            nullable: true
          control_plane_group:
            description: Control Plane Group ID associated with the request.
            type: string
            nullable: true
          country_code:
            description: Country code associated with the request.
            type: string
            nullable: true
          data_plane_node:
            description: Data Plane Node ID associated with the request. In the format
              `control_plane_id:data_plane_node_id` if the node belongs to a
              control plane or `control_plane_group_id:data_plane_node_id` if
              the node belongs to a control plane group.
            type: string
          data_plane_node_version:
            description: Version used by the Data Plane Node associated with the request.
            type: string
          gateway_service:
            description: Gateway Service ID associated with the request. In the format
              `control_plane_id:gateway_service_id`.
            type: string
            nullable: true
          header_host:
            description: Header host associated with the request.
            type: string
            nullable: true
          header_user_agent:
            description: Header user agent associated with the request.
            type: string
            nullable: true
          http_method:
            description: HTTP method associated with the request.
            type: string
            nullable: true
          latencies_kong_gateway_ms:
            description: Kong Gateway latency of the request in milliseconds.
            type: integer
            nullable: true
          latencies_response_ms:
            description: Response latency of the request in milliseconds.
            type: integer
            nullable: true
          latencies_upstream_ms:
            description: Upstream latency of the request in milliseconds.
            type: integer
            nullable: true
          mcp_info:
            description: MCP (Model Context Protocol) session information associated with
              the request, including RPC call details.
            type: object
            nullable: true
            properties:
              mcp_session_id:
                description: Unique session identifier for the MCP request.
                type: string
              rpc:
                description: Array of RPC calls made during the MCP session.
                type: array
                items:
                  type: object
                  properties:
                    id:
                      description: Unique identifier for the RPC call.
                      type: string
                      nullable: true
                    method:
                      description: The RPC method name.
                      type: string
                      nullable: true
                    tool_name:
                      description: Name of the tool invoked.
                      type: string
                      nullable: true
                    latency:
                      description: Latency of the RPC call in milliseconds.
                      type: integer
                      nullable: true
                    response_body_size:
                      description: Size of the RPC response body in bytes.
                      type: integer
                      nullable: true
                    error:
                      description: Error message from the RPC call, if any.
                      type: string
                      nullable: true
          portal:
            description: Portal ID associated with the request.
            type: string
            nullable: true
          ratelimit_enabled:
            description: True if rate limiting is enabled for at least one of the intervals
              second, minute, hour, day, year.
            type: integer
          ratelimit_enabled_day:
            description: True if rate limiting is enabled for the day interval.
            type: integer
          ratelimit_enabled_hour:
            description: True if rate limiting is enabled for the hour interval.
            type: integer
          ratelimit_enabled_minute:
            description: True if rate limiting is enabled for the minute interval.
            type: integer
          ratelimit_enabled_month:
            description: True if rate limiting is enabled for the month interval.
            type: integer
          ratelimit_enabled_second:
            description: True if rate limiting is enabled for the second interval.
            type: integer
          ratelimit_enabled_year:
            description: True if rate limiting is enabled for the year interval.
            type: integer
          ratelimit_limit:
            description: Rate limit value.
            type: integer
          ratelimit_limit_day:
            description: Rate limit value for requests per day.
            type: integer
          ratelimit_limit_hour:
            description: Rate limit value for requests per hour.
            type: integer
          ratelimit_limit_minute:
            description: Rate limit value for requests per minute.
            type: integer
          ratelimit_limit_month:
            description: Rate limit value for requests per month.
            type: integer
          ratelimit_limit_second:
            description: Rate limit value for requests per second.
            type: integer
            nullable: true
          ratelimit_limit_year:
            description: Rate limit value for requests per year.
            type: integer
            nullable: true
          ratelimit_remaining:
            description: Number of requests remaining until the limit is hit.
            type: integer
            nullable: true
          ratelimit_remaining_day:
            description: Number of requests remaining until the limit is hit for requests
              per day.
            type: integer
            nullable: true
          ratelimit_remaining_hour:
            description: Number of requests remaining until the limit is hit for requests
              per hour.
            type: integer
            nullable: true
          ratelimit_remaining_minute:
            description: Number of requests remaining until the limit is hit for requests
              per minute.
            type: integer
            nullable: true
          ratelimit_remaining_month:
            description: Number of requests remaining until the limit is hit for requests
              per month.
            type: integer
            nullable: true
          ratelimit_remaining_second:
            description: Number of requests remaining until the limit is hit for requests
              per second.
            type: integer
            nullable: true
          ratelimit_remaining_year:
            description: Number of requests remaining until the limit is hit for requests
              per year.
            type: integer
            nullable: true
          ratelimit_reset:
            description: The time, in seconds, until the quota is reset.
            type: integer
            nullable: true
          request_body_size:
            description: Request body size of the request in bytes.
            type: integer
            nullable: true
          request_id:
            description: Request ID associated with the request.
            type: string
            nullable: true
          request_uri:
            description: Request URI associated with the request.
            type: string
            nullable: true
          response_body_size:
            description: Response body size of the request in bytes.
            type: integer
            nullable: true
          response_header_content_length:
            description: Response header content length in bytes.
            type: integer
            nullable: true
          response_header_content_type:
            description: The content type for the returned response.
            type: string
            nullable: true
          response_http_status:
            description: Response HTTP status code returned from the request.
            type: string
            nullable: true
          response_source:
            description: Response source associated with the response status.
            type: string
            nullable: true
          route:
            description: Route ID associated with the request. In the format
              `control_plane_id:route_id`.
            type: string
            nullable: true
          service_port:
            description: Service port associated with the request.
            type: string
            nullable: true
          service_protocol:
            description: Service protocol associated with the request.
            type: string
            nullable: true
          trace_id:
            description: ID used to trace the query.
            type: string
            nullable: true
          upstream_status:
            description: Upstream URI associated with the request.
            type: integer
            nullable: true
          upstream_uri:
            description: Upstream URI associated with the request.
            type: string
            nullable: true
    ResponseMeta:
      description: Meta information about the returned query response.
      type: object
      properties:
        time_range:
          description: Period of time data is returned for.
          type: object
          additionalProperties: false
          properties:
            start:
              description: Timestamp specifying the lower bound of the query's time range.
              type: string
              format: date-time
            end:
              description: Timestamp specifying the upper bound of the query's time range.
              type: string
              format: date-time
        query_id:
          description: Unique identifier for the query; can be used to debug issues.
          type: string
        size:
          description: Number of requests returned.
          type: integer
          default: 100
          maximum: 1000
        offset:
          description: Number of requests skipped when returning results.
          type: integer
          default: 0
      additionalProperties: false
      required:
        - time_range
        - query_id
        - size
        - offset
    UnauthorizedError:
      allOf:
        - $ref: "#/components/schemas/BaseError"
        - type: object
          properties:
            status:
              example: 401
            title:
              example: Unauthorized
            type:
              example: https://httpstatuses.com/401
            instance:
              example: kong:trace:1234567890
            detail:
              example: Invalid credentials
    ForbiddenError:
      allOf:
        - $ref: "#/components/schemas/BaseError"
        - type: object
          properties:
            status:
              example: 403
            title:
              example: Forbidden
            type:
              example: https://httpstatuses.com/403
            instance:
              example: kong:trace:1234567890
            detail:
              example: Forbidden
    A2aContextIdFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - a2a_context_id
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by a2a_context_id
    A2aErrorFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - a2a_error
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by a2a_error
    A2aMethodFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - a2a_method
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by a2a_method
    A2aTaskIdFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - a2a_task_id
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by a2a_task_id
    ApiFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - api
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by api
    ApiPackageFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - api_package
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by api package
    ApiProductFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by api_product
    ApiProductVersionFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - api_product_version
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by api_product_version
    ApplicationFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - application
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by application
    AuthTypeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - auth_type
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by auth_type
    ClientIpFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - client_ip
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by client_ip
    ConsumerFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - consumer
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueScopedUUID"
            - $ref: "#/components/schemas/FilterSingleValueScopedUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by consumer
    ControlPlaneFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by control_plane
    ControlPlaneGroupFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - control_plane_group
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by control_plane_group
    CountryCodeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - country_code
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by country_code
    DataPlaneNodeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueScopedUUID"
            - $ref: "#/components/schemas/FilterSingleValueScopedUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by data_plane_node
    DataPlaneNodeVersionFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - data_plane_node_version
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by data_plane_node_version
    GatewayServiceFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - gateway_service
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueScopedUUID"
            - $ref: "#/components/schemas/FilterSingleValueScopedUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by gateway_service
    HeaderHostFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - header_user_host
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by header_user_host
    HeaderUserAgentFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - header_user_agent
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by header_user_agent
    HttpMethodFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - http_method
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by http_method
    LatenciesKongGatewayMsFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - latencies_kong_gateway_ms
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterSingleValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by latencies_kong_gateway_ms
    LatenciesResponseMsFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - latencies_response_ms
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterSingleValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by latencies_response_ms
    LatenciesUpstreamMsFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - latencies_upstream_ms
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterSingleValueNumericMilliseconds"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by latencies_upstream_ms
    McpErrorFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - mcp_error
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by mcp_error
    McpMethodFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - mcp_method
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by mcp_method
    McpSessionIdFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - mcp_session_id
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by mcp_session_id
    McpToolNameFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - mcp_tool_name
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by mcp_tool_name
    PortalFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - portal
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by portal
    RealmFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - realm
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueUUID"
            - $ref: "#/components/schemas/FilterSingleValueUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by realm
    ResponseBodySizeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - response_body_size
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericBytes"
            - $ref: "#/components/schemas/FilterSingleValueNumericBytes"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by response_body_size
    ResponseHeaderContentLengthFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - response_body_size
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericBytes"
            - $ref: "#/components/schemas/FilterSingleValueNumericBytes"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by response_header_content_length
    ResponseSourceFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - response_source
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by response_source
    RequestBodySizeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - request_body_size
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueNumericBytes"
            - $ref: "#/components/schemas/FilterSingleValueNumericBytes"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by request_body_size
    RequestIdFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - request_id
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by request_id
    RequestUriFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - request_uri
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by request_uri
    ResponseHeaderContentTypeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - response_header_content_type
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by response_header_content_type
    RouteFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - route
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueScopedUUID"
            - $ref: "#/components/schemas/FilterSingleValueScopedUUID"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by route
    ServicePortFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - service_port
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by service_port
    ServiceProtocolFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - service_protocol
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by service_protocol
    StatusCodeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueStatusCode"
            - $ref: "#/components/schemas/FilterSingleValueStatusCode"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by status_code
    StatusCodeGroupedFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - status_code_grouped
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueStatusCodeGrouped"
            - $ref: "#/components/schemas/FilterSingleValueStatusCodeGrouped"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by status_code_grouped
    TraceIdFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - trace_id
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by trace_id
    UpstreamStatusCodeFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueStatusCode"
            - $ref: "#/components/schemas/FilterSingleValueStatusCode"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by upstream_status_code
    UpstreamStatusCodeGroupedFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_status_code_grouped
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueStatusCodeGrouped"
            - $ref: "#/components/schemas/FilterSingleValueStatusCodeGrouped"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by upstream_status_code_grouped
    UpstreamUriFilterByField:
      allOf:
        - type: object
          properties:
            field:
              description: The field to filter.
              type: string
              enum:
                - upstream_uri
          required:
            - field
        - oneOf:
            - $ref: "#/components/schemas/FilterMultiValueString"
            - $ref: "#/components/schemas/FilterSingleValueString"
            - $ref: "#/components/schemas/FilterWildcard"
            - $ref: "#/components/schemas/FilterEmpty"
      title: Filter by upstream_uri
    FilterTimeRange:
      description: The period of time to return data. Relative time ranges are
        relative to the current moment. Absolute time ranges specify an
        unchanging period of time. If not specified, a default relative
        timeframe of 1 hour will be chosen.
      default:
        type: relative
        time_range: 1H
      discriminator:
        propertyName: type
        mapping:
          relative: "#/components/schemas/RequestsRelativeTimeRange"
          absolute: "#/components/schemas/RequestsAbsoluteTimeRange"
      oneOf:
        - $ref: "#/components/schemas/RequestsRelativeTimeRange"
        - $ref: "#/components/schemas/RequestsAbsoluteTimeRange"
    FilterOrder:
      description: Order of results sorted by time.
      type: string
      default: descending
      enum:
        - ascending
        - descending
    FilterSize:
      description: Number of requests to be returned.
      type: integer
      default: 100
      maximum: 1000
    FilterOffset:
      description: Number of requests to be skipped when returning results.
      type: integer
      default: 0
    ApiProductFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - api_product
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      additionalProperties: false
      required:
        - dimension
        - type
        - values
      title: Filter by api_product
    ApiProductVersionFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - api_product_version
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by api_product_version
    ApplicationFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - application
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by application
    ConsumerFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - consumer
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/ScopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by consumer
    ControlPlaneFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - control_plane
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by control_plane
    ControlPlaneGroupFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - control_plane_group
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by control_plane_group
    DataPlaneNodeFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - data_plane_node
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/ScopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by data_plane_node
    GatewayServiceFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - gateway_service
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/ScopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by gateway_service
    RouteFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - route
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/ScopedUuid"
      required:
        - dimension
        - type
        - values
      title: Filter by route
    StatusCodeFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - status_code
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The codes to include in the results.
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 999
      required:
        - dimension
        - type
        - values
      title: Filter by status_code
    StatusCodeGroupedFilterByDimension:
      type: object
      properties:
        dimension:
          description: The dimension to filter.  This will be deprecated in favor of
            `field`.
          type: string
          enum:
            - status_code_grouped
        type:
          $ref: "#/components/schemas/RequestsFilterType"
        values:
          description: |
            The codes to include in the results.
          type: array
          items:
            type: string
            pattern: ^\d[xX][xX]$
      required:
        - dimension
        - type
        - values
      title: Filter by status_code_grouped
    BaseError:
      description: standard error
      type: object
      properties:
        status:
          description: >
            The HTTP status code of the error. Useful when passing the response

            body to child properties in a frontend UI. Must be returned as an
            integer.
          type: integer
          readOnly: true
        title:
          description: |
            A short, human-readable summary of the problem. It should not
            change between occurences of a problem, except for localization.
            Should be provided as "Sentence case" for direct use in the UI.
          type: string
          readOnly: true
        type:
          description: The error type.
          type: string
          readOnly: true
        instance:
          description: |
            Used to return the correlation ID back to the user, in the format
            kong:trace:<correlation_id>. This helps us find the relevant logs
            when a customer reports an issue.
          type: string
          readOnly: true
        detail:
          description: >
            A human readable explanation specific to this occurence of the
            problem.

            This field may contain request/entity data to help the user
            understand

            what went wrong. Enclose variable values in square brackets. Should
            be

            provided as "Sentence case" for direct use in the UI.
          type: string
          readOnly: true
      required:
        - status
        - title
        - instance
        - detail
      title: Error
    FilterMultiValueString:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: |
            The values to include in the results.
          type: array
          items:
            type: string
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueString:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEquals"
        value:
          description: |
            The value to include in the results
          type: string
      required:
        - operator
        - value
      title: Single select filters
    FilterEmpty:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEmpty"
      required:
        - operator
      title: Empty filters
    FilterMultiValueUUID:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: |
            The IDs to include in the results.
          type: array
          items:
            $ref: "#/components/schemas/UnscopedUuid"
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueUUID:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEquals"
        value:
          description: |
            The ID to include in the results.
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      required:
        - operator
        - value
      title: Single select filters
    FilterWildcard:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeWildcard"
        value:
          description: |
            The value to include in the results
          type: string
      required:
        - operator
        - value
      title: Wildcard filters
    FilterMultiValueScopedUUID:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: >
            The IDs to include in the results. Because gateway IDs are only
            unique within a given control plane, the filter values must be of
            the form `control_plane_id:field_id` or
            `control_plane_group_id:field_id` for data plane nodes within a
            control plane group.
          type: array
          items:
            $ref: "#/components/schemas/ScopedUuid"
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueScopedUUID:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEquals"
        value:
          description: >
            The ID to include in the results. Because gateway IDs are only
            unique within a given control plane, the filter values must be of
            the form `control_plane_id:field_id` or
            `control_plane_group_id:field_id` for data plane nodes within a
            control plane group.
          type: string
          pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
      required:
        - operator
        - value
      title: Single select filters
    FilterMultiValueNumericMilliseconds:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: >
            The values to include in the results. The values should be in
            milliseconds.
          type: array
          items:
            type: integer
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueNumericMilliseconds:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeNumeric"
        value:
          description: >
            The value to include in the results. The value should be in
            milliseconds.
          type: integer
      required:
        - operator
        - value
      title: Numeric filters
    FilterMultiValueNumericBytes:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: |
            The values to include in the results. The values should be in bytes.
          type: array
          items:
            type: integer
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueNumericBytes:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeNumeric"
        value:
          description: |
            The value to include in the results. The value should be in bytes.
          type: integer
      required:
        - operator
        - value
      title: Numeric filters
    FilterMultiValueStatusCode:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: |
            The codes to include in the results.
          type: array
          items:
            type: integer
            minimum: 0
            maximum: 999
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueStatusCode:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEquals"
        value:
          description: |
            The code to include in the results.
          type: integer
          maximum: 999
          minimum: 0
      required:
        - operator
        - value
      title: Single select filters
    FilterMultiValueStatusCodeGrouped:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterType"
        value:
          description: |
            The code groups to include in the results.
          type: array
          items:
            type: string
            pattern: ^\d[xX][xX]$
      required:
        - operator
        - value
      title: Multiselect filters
    FilterSingleValueStatusCodeGrouped:
      type: object
      properties:
        operator:
          $ref: "#/components/schemas/RequestsFilterTypeEquals"
        value:
          description: |
            The code group to include in the results.
          type: string
          pattern: ^\d[xX][xX]$
      required:
        - operator
        - value
      title: Single select filters
    RequestsRelativeTimeRange:
      type: object
      properties:
        tz:
          description: >
            The time zone of the requestor, provided as a string matching the

            tz database.  This helps determine day boundaries for relative time

            ranges spanning more than 24 hours: for example, submitting a
            request

            for data from the last 7 days on `2020-01-08T00:00:00` in timezone

            US/Eastern will find results starting from `2020-01-01T05:00:00Z`
            (UTC).
          type: string
          example: US/Eastern
          default: Etc/UTC
        type:
          description: |
            Request data from a time relative to the current time.
          type: string
          enum:
            - relative
        time_range:
          description: >
            Return results from the last fifteen minutes, one hour, six hours,
            etc.
          type: string
          default: 12H
          enum:
            - 15M
            - 1H
            - 6H
            - 12H
            - 24H
            - 7D
      additionalProperties: false
      required:
        - type
        - time_range
    RequestsAbsoluteTimeRange:
      type: object
      properties:
        tz:
          description: |
            The time zone of the requestor.  This is used to localize the start
            and end times, if desired: for example, requesting a start time of
            `2020-01-01T00:00:00` in timezone US/Eastern will find results
            starting from `2020-01-01T05:00:00Z` (UTC).
          type: string
          example: US/Eastern
          default: Etc/UTC
        type:
          description: >
            Request data from a specific time range.  Note that the requested

            times must be within the data retention period for your
            organization.
          type: string
          enum:
            - absolute
        start:
          description: The start time in the given timezone.
          type: string
          format: date-time
          example: 2020-01-01T00:00:00
        end:
          description: The end time in the given timezone.
          type: string
          format: date-time
          example: 2020-01-01T00:00:00
      additionalProperties: false
      required:
        - type
        - start
        - end
    RequestsFilterType:
      description: The type of filter to apply.  `in` filters will limit results to
        only the specified values, while `not_in` filters will exclude the
        specified values.
      type: string
      enum:
        - in
        - not_in
    UnscopedUuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
    ScopedUuid:
      type: string
      pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}:[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
    RequestsFilterTypeEquals:
      description: The type of filter to apply.
      type: string
      enum:
        - =
        - "!="
    RequestsFilterTypeEmpty:
      description: The type of filter to apply.
      type: string
      enum:
        - empty
        - not_empty
    RequestsFilterTypeWildcard:
      description: The type of filter to apply. `starts_with` filters will limit the
        results to those that start with the specified value. `ends_with` will
        limit the results to those that end with the specified value.
      type: string
      enum:
        - starts_with
        - ends_with
    RequestsFilterTypeNumeric:
      description: The type of filter to apply.
      type: string
      enum:
        - =
        - "!="
        - <
        - ">"
        - <=
        - ">="
  examples:
    ExampleMultiselectFilters:
      value:
        time_range:
          type: relative
          time_range: 24H
          tz: EST
        filters:
          - operator: in
            field: api_product
            value:
              - 523468b1-2e74-4b58-b30e-6f904e99e4d0
              - c19b3f76-ef71-484a-bbc8-a07812a980b3
          - operator: in
            field: gateway_service
            value:
              - d5ac5d88-efed-4e10-9dfe-0b0a6646c219:523468b1-2e74-4b58-b30e-6f904e99e4d0
          - operator: not_in
            field: http_method
            value:
              - OPTIONS
              - GET
          - operator: not_in
            field: status_code_grouped
            value:
              - 2XX
          - operator: not_in
            field: status_code
            value:
              - 200
    ExampleSingleSelectFilters:
      value:
        time_range:
          type: relative
          time_range: 24H
          tz: EST
        filters:
          - operator: =
            field: application
            value: bc2587ae-a35e-4a34-b6b2-f4ca5ae06dc9
          - operator: "!="
            field: route
            value: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:523468b1-2e74-4b58-b30e-6f904e99e4d0
          - operator: =
            field: service_protocol
            value: https
          - operator: =
            field: status_code_grouped
            value: 5XX
    ExampleNumericFilters:
      value:
        time_range:
          type: relative
          time_range: 15M
          tz: EST
        filters:
          - operator: ">="
            field: latencies_response_ms
            value: 5000
          - operator: <
            field: latencies_response_ms
            value: 10000
          - operator: =
            field: status_code
            value: 500
    ExampleWildcardFilters:
      value:
        time_range:
          type: relative
          time_range: 15M
          tz: EST
        filters:
          - operator: starts_with
            field: request_uri
            value: /users/
          - operator: ends_with
            field: request_uri
            value: v2/accounts
    ExampleEmptyFilters:
      value:
        time_range:
          type: relative
          time_range: 15M
          tz: EST
        filters:
          - operator: not_empty
            field: api_product
          - operator: empty
            field: consumer
    ExampleAbsoluteTimeRangeAndPagination:
      value:
        time_range:
          type: absolute
          start: 2023-08-12T00:00:00
          end: 2023-08-13T00:00:00
          tz: America/Denver
        filters:
          - operator: in
            field: application
            value:
              - 147bbc1a-b58a-484f-afd2-6479a70c0548
        size: 10
        offset: 100
    BadRequestExample:
      value:
        status: 400
        title: Invalid Request
        instance: kong:trace:6591723055278037644
        detail: Invalid Parameters
        invalid_parameters:
          - field: time_range.time_range
            rule: unknown_property
            choices: []
            reason: property time_range should not exist
    ResponseExample:
      value:
        results:
          - request_start: 2020-02-02T01:00:00.000Z
            a2a_info:
              rpc:
                - id: 58fccc27-0043-493b-b12c-7cab0205e616
                  method: message/send
                  context_id: cf9dd0cf-e5f9-4864-9261-14225703dc1f
                  task_id: f7c459b2-6031-43cf-8b51-710aa6c6a1a5
                  task_state: AI_A2A_TASK_STATE_COMPLETED
                  latency: 32
                  response_body_size: 239
                  error: null
            api: null
            api_package: null
            api_product: 523468b1-2e74-4b58-b30e-6f904e99e4d0
            api_product_version: d40a6dd7-37e8-4937-8dfd-9fa988c7fc3e
            application: bc2587ae-a35e-4a34-b6b2-f4ca5ae06dc9
            auth_type: key-auth
            client_ip: 131.174.120.249
            consumer: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:d69557ff-277c-4579-a821-4f8d158ae070
            control_plane: d5ac5d88-efed-4e10-9dfe-0b0a6646c219
            control_plane_group: cafe2d4f-95ec-458c-8c88-62417018678d
            country_code: CN
            data_plane_node: cafe2d4f-95ec-458c-8c88-62417018678d:122a0f86-029c-4292-82fd-f3b38e1cfa60
            data_plane_node_version: 3.8.0.1
            gateway_service: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:523468b1-2e74-4b58-b30e-6f904e99e4d0
            header_host: google.com
            header_user_agent: Mozilla/4.0 (compatible; Flight Explorer)
            http_method: OPTIONS
            latencies_kong_gateway_ms: 2
            latencies_response_ms: 117
            latencies_upstream_ms: 115
            mcp_info:
              mcp_session_id: mcp-sess-abc123
              rpc:
                - id: rpc-001
                  method: tools/call
                  tool_name: get_weather
                  latency: 45
                  response_body_size: 1024
                  error: null
            portal: 20076d8c-2d1b-4249-b323-4baa63796f8a
            ratelimit_enabled: 1
            ratelimit_enabled_day: 0
            ratelimit_enabled_hour: 0
            ratelimit_enabled_minute: 1
            ratelimit_enabled_month: 0
            ratelimit_enabled_second: 0
            ratelimit_enabled_year: 0
            ratelimit_limit: 0
            ratelimit_limit_day: 0
            ratelimit_limit_hour: 0
            ratelimit_limit_minute: 2000
            ratelimit_limit_month: 0
            ratelimit_limit_second: 0
            ratelimit_limit_year: 0
            ratelimit_remaining: 498
            ratelimit_remaining_day: 0
            ratelimit_remaining_hour: 0
            ratelimit_remaining_minute: 1997
            ratelimit_remaining_month: 0
            ratelimit_remaining_second: 0
            ratelimit_remaining_year: 0
            ratelimit_reset: 0
            request_body_size: 182
            request_id: f3043125bdec40385195f20db7e0491b
            request_uri: /notifications/graphql
            response_body_size: 431
            response_header_content_length: 41
            response_header_content_type: application/json; charset=utf-8
            response_http_status: "204"
            route: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:2a3e9d21-804b-4b3b-ab7e-c6f002dadbf4
            service_port: "4000"
            service_protocol: http
            trace_id: 36b95ea3a6be443d11866fb5d2a8ba6b
            upstream_status: null
            upstream_uri: /graphql
          - request_start: 2020-02-02T01:00:01.050Z
            a2a_info: null
            api: null
            api_package: af4d23b1-d1cd-4fc3-8939-94fbfead746e
            api_product: b866c867-60e6-4258-adb3-e136cc26388b
            api_product_version: 3807c200-3d10-445d-85b2-7afe07ca3932
            application: null
            auth_type: null
            client_ip: 131.174.120.249
            consumer: null
            control_plane: d5ac5d88-efed-4e10-9dfe-0b0a6646c219
            control_plane_group: null
            country_code: US
            data_plane_node: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:a3e0692c-2351-4c8e-acbe-e7a5185147de
            data_plane_node_version: 3.8.0.1
            gateway_service: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:523468b1-2e74-4b58-b30e-6f904e99e4d0
            header_host: proxy-zyq.com
            header_user_agent: python-works
            http_method: GET
            latencies_kong_gateway_ms: 2
            latencies_response_ms: 12
            latencies_upstream_ms: 10
            mcp_info: null
            portal: null
            ratelimit_enabled: 1
            ratelimit_enabled_day: 0
            ratelimit_enabled_hour: 1
            ratelimit_enabled_minute: 0
            ratelimit_enabled_month: 0
            ratelimit_enabled_second: 1
            ratelimit_enabled_year: 0
            ratelimit_limit: 100
            ratelimit_limit_day: 0
            ratelimit_limit_hour: 30000
            ratelimit_limit_minute: 0
            ratelimit_limit_month: 0
            ratelimit_limit_second: 100
            ratelimit_limit_year: 0
            ratelimit_remaining: 99
            ratelimit_remaining_day: 0
            ratelimit_remaining_hour: 29981
            ratelimit_remaining_minute: 0
            ratelimit_remaining_month: 0
            ratelimit_remaining_second: 99
            ratelimit_remaining_year: 0
            ratelimit_reset: 0
            request_body_size: 258
            request_id: a193bb0fefadcd3948cebc2c2c63a500
            request_uri: /users
            response_body_size: 390
            response_header_content_length: 102
            response_header_content_type: text/html
            response_http_status: "200"
            response_source: upstream
            route: d5ac5d88-efed-4e10-9dfe-0b0a6646c219:2a3e9d21-804b-4b3b-ab7e-c6f002dadbf4
            service_port: "443"
            service_protocol: https
            trace_id: 77ea76d5f4e24fcae336d3ec2c9c92e3
            upstream_status: 200
            upstream_uri: /users
        meta:
          size: 15
          offset: 0
          query_id: apilog-11AF3891-C638-43E6-A85A-4EBCCAF0E690
          time_range:
            start: 2020-02-02T00:00:00.000Z
            end: 2020-02-03T00:00:00.000Z
    UnauthorizedExample:
      value:
        status: 401
        title: Unauthorized
        instance: kong:trace:8347343766220159418
        detail: Unauthorized
    ForbiddenExample:
      value:
        status: 403
        title: Forbidden
        instance: kong:trace:2723154947768991354
        detail: You do not have permission to perform this action
  responses:
    AnalyticsRequestsResponse:
      description: Response from the Analytics Requests API.
      content:
        application/json:
          schema:
            type: object
            properties:
              results:
                $ref: "#/components/schemas/ResponseResults"
              meta:
                $ref: "#/components/schemas/ResponseMeta"
            additionalProperties: false
            required:
              - results
              - meta
          examples:
            Response example:
              $ref: "#/components/examples/ResponseExample"
    Unauthorized:
      description: Unauthorized
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/UnauthorizedError"
          examples:
            UnauthorizedExample:
              $ref: "#/components/examples/UnauthorizedExample"
    Forbidden:
      description: Forbidden
      content:
        application/problem+json:
          schema:
            $ref: "#/components/schemas/ForbiddenError"
          examples:
            UnauthorizedExample:
              $ref: "#/components/examples/ForbiddenExample"
  securitySchemes:
    personalAccessToken:
      type: http
      scheme: bearer
      bearerFormat: Token
      description: >
        The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs.

        You can generate a Personal Access Token (PAT) from the [personal access
        token page](https://cloud.konghq.com/global/account/tokens/) in the
        Konnect dashboard.

        The PAT token must be passed in the header of a request, for example:

        `curl -X GET 'https://global.api.konghq.com/v2/users/' --header
        'Authorization: Bearer kpat_xgfT...'`
```
