v50

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-07-068428533.0 MB
Control Planes

List Control Planes Datasource

Returns an array of control plane objects containing information about the Konnect Control Planes.

get/v2/control-planes#single-resource

Query parameters

cloud_gatewayboolean

Filter by a boolean value (true/false).

Filters a collection of control-planes.

labelsstring
Example:key:value,existCheck

Filter control planes in the response by associated labels.

sortstring

The asc suffix is optional as the default sort order is ascending. The desc suffix is used to specify a descending order. Multiple sort attributes may be provided via a comma separated list. JSONPath notation may be used to specify a sub-attribute (eg: 'foo.bar desc').

Example:created_at desc

Sorts a collection of control-planes. Supported sort attributes are:

  • created_at

Response

A paginated list response for a collection of control planes.

Example response

{
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  },
  "data": [
    {
      "id": "7f9fd312-a987-4628-b4c5-bb4f4fddd5f7",
      "name": "Test Control Plane",
      "description": "A test control plane for exploration.",
      "labels": {
        "env": "test"
      },
      "config": {
        "control_plane_endpoint": "https://acfe5f253f.cp.konghq.com",
        "telemetry_endpoint": "https://acfe5f253f.tp0.konghq.com",
        "cluster_type": "CLUSTER_TYPE_CONTROL_PLANE",
        "auth_type": "pinned_client_certs",
        "proxy_urls": [
          {
            "host": "example.com",
            "port": 443,
            "protocol": "https"
          }
        ]
      },
      "created_at": "2022-11-04T20:10:06.927Z",
      "updated_at": "2022-11-04T20:10:06.927Z"
    }
  ]
}