Dashboards

Get a single dashboard

Get a dashboard that your account has access to.

get/v2/dashboards/{dashboardId}

Response

The dashboard with the given ID.

namestring required

The dashboard name, which is displayed at the top of the dashboard and in lists. It does not need to be unique.

labelsLabels

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

idstring uuid

Contains a unique identifier used for this resource.

created_bystring uuid

Contains a unique identifier used for this resource.

created_atstring date-time

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "definition": {
    "tiles": [
      {
        "layout": {
          "position": {
            "col": 3,
            "row": 0
          },
          "size": {
            "cols": 3,
            "rows": 1
          }
        },
        "definition": {
          "query": {
            "datasource": "api_usage",
            "time_range": {
              "type": "relative",
              "time_range": "24h",
              "tz": "EST"
            },
            "dimensions": [
              "time",
              "gateway_service"
            ],
            "filters": [
              {
                "operator": "in",
                "field": "control_plane",
                "value": [
                  "d5ac5d88-efed-4e10-9dfe-0b0a6646c219"
                ]
              }
            ],
            "granularity": "hourly",
            "metrics": [
              "request_count",
              "response_latency_p99"
            ]
          }
        }
      }
    ],
    "preset_filters": [
      {
        "operator": "in",
        "field": "control_plane",
        "value": [
          "00000000-0000-0000-0000-000000000000"
        ]
      },
      {
        "operator": "in",
        "field": "ai_request_model",
        "value": [
          "request_model1"
        ]
      }
    ]
  },
  "labels": {
    "env": "test"
  },
  "id": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
  "created_by": "5f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}

Changes

Changed in 9 of the 75 revisions of this API.7417

  • b576ea92fca2151See the full diff
    • added ManagedCacheUsageQuery to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query response property oneOf list for the response status 200

      response-property-one-of-added

    • added the new data_plane_group enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new managed_cache enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new network enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new provider enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new provider_region enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added managed_cache_usage discriminator mapping keys to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query response property for the response status 200

      response-property-discriminator-mapping-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new cache_hit_rate enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new cache_hit_rate enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AgenticQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new cache_status enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new cache_status enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AdvancedQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new cache_status enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AdvancedQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new cache_status enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AgenticQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new cache_status enum value to the definition/tiles/items/oneOf[ChartTile]/definition/oneOf[ChartTileDefinition]/query/oneOf[AgenticQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added ChartTileDefinition TableChartTileDefinition to the definition/tiles/items/oneOf[ChartTile]/definition response property oneOf list for the response status 200

      response-property-one-of-added

    • the definition/tiles/items/oneOf[ChartTile]/definition response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • removed the required property definition/tiles/items/oneOf[ChartTile]/definition/chart from the response with the 200 status

      response-required-property-removed

    • removed the required property definition/tiles/items/oneOf[ChartTile]/definition/query from the response with the 200 status

      response-required-property-removed

    • added the optional property definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/limit to the response with the 200 status

      response-optional-property-added

    • added the optional property definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/limit to the response with the 200 status

      response-optional-property-added

    • added the optional property definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[LLMQuery]/limit to the response with the 200 status

      response-optional-property-added

    • added the new env enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new env enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new env enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new hostname enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new hostname enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new hostname enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new region enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new region enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new region enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new team enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new team enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new team enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[PlatformQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/preset_filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[LLMQuery]/dimensions/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new principal enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[LLMQuery]/filters/items/field response property for the response status 200

      response-property-enum-value-added

    This revision also has 23 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 164458859caa11See the full diff
    • added TopNChart to the definition/tiles/items/oneOf[ChartTile]/definition/chart response property oneOf list for the response status 200

      response-property-one-of-added

    • added top_n discriminator mapping keys to the definition/tiles/items/oneOf[ChartTile]/definition/chart response property for the response status 200

      response-property-discriminator-mapping-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • c83332d134eb1101See the full diff
    • added PlatformQuery to the definition/tiles/items/oneOf[ChartTile]/definition/query response property oneOf list for the response status 200

      response-property-one-of-added

    • added the new error_rate enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new error_rate enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[LLMQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_average enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_average enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p50 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p50 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p95 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p95 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p99 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AdvancedQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added the new kong_internal_latency_p99 enum value to the definition/tiles/items/oneOf[ChartTile]/definition/query/oneOf[AgenticQuery]/metrics/items/ response property for the response status 200

      response-property-enum-value-added

    • added platform_usage discriminator mapping keys to the definition/tiles/items/oneOf[ChartTile]/definition/query response property for the response status 200

      response-property-discriminator-mapping-added

    • endpoint added

      endpoint-added