2.0.0OAS 3.0

Konnect endpoint for creating, reading, updating, and deleting dashboards. Dashboards are entities within Konnect that contain tiles, which are essentially saved queries combined with configuration for a chart to render the data.

API Base URL
  • Server 1:https://us.api.konghq.com/v2

    United-States Production region

  • Server 2:https://eu.api.konghq.com/v2

    Europe Production region

  • Server 3:https://au.api.konghq.com/v2

    Australia Production region

  • Server 4:https://me.api.konghq.com/v2

    Middle-East Production region

  • Server 5:https://in.api.konghq.com/v2

    India Production region

  • Server 6:https://sg.api.konghq.com/v2

    Singapore Production region

Security
personalAccessToken (http)

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 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...'

systemAccountAccessToken (http)

The system account access token is meant for automations and integrations that are not directly associated with a human identity.
You can generate a system account Access Token by creating a system account and then obtaining a system account access token for that account.
The access 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 spat_i2Ej...'

Additional Information
Contact Kong

Dashboards

List dashboards

Get a paginated list of dashboards that your account has access to.

get

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

filterobject

Filters dashboards in the response.

Show Child Parameters
sortstring

Sorts a collection of dashboards. Supported sort attributes are:

  • name
  • created_at
  • updated_at

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.

Example:created_at desc

Response

application/json

List of dashboards

metaobject

returns the pagination information

Show Child Parameters
dataarray[object]
Show Child Parameters
get/dashboards
 
application/json

Create a new dashboard

Creates a new dashboard from the provided definition.

post

Body

application/json

Dashboard Request

namestringrequired

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

>= 1 characters<= 255 characters

definitionobjectrequired

A JSON object describing a dashboard.

A dashboard is an array of tiles. All tiles are of type ‘chart’, which query data and render a chart displaying that data.

Dashboards have 6 columns and as many rows as necessary to display their tiles.

* Additional properties are NOT allowed.
Show Child Parameters
labelsobject

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 “_”.

Example:{"env":"test"}

Response

application/json

The created dashboard, including generated fields.

Dashboard Request

namestringrequired

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

>= 1 characters<= 255 characters

definitionobjectrequired

A JSON object describing a dashboard.

A dashboard is an array of tiles. All tiles are of type ‘chart’, which query data and render a chart displaying that data.

Dashboards have 6 columns and as many rows as necessary to display their tiles.

* Additional properties are NOT allowed.
Show Child Parameters
labelsobject

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 “_”.

Example:{"env":"test"}

idstring(uuid)read-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

created_bystring(uuid)read-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

post/dashboards

Body

{ "name": "Single Tile, Timeseries Line", "definition": { "tiles": [ { "type": "chart", "layout": { "position": { "col": 0, "row": 0 }, "size": { "cols": 3, "rows": 2 } }, "definition": { "chart": { "type": "timeseries_line", "stacked": false, "chart_title": "Plot of p99, p95, and p50 latency over time" }, "query": { "datasource": "api_usage", "dimensions": [ "time" ], "metrics": [ "response_latency_p99", "response_latency_p95", "response_latency_p50" ] } } } ] } }
 
application/json

Get a single dashboard

Get a dashboard that your account has access to.

get

Path Parameters

dashboardIdstring(uuid)required

The dashboard’s ID.

Example:d32d905a-ed33-46a3-a093-d8f536af9a8a

Response

application/json

The dashboard with the given ID.

Dashboard Request

namestringrequired

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

>= 1 characters<= 255 characters

definitionobjectrequired

A JSON object describing a dashboard.

A dashboard is an array of tiles. All tiles are of type ‘chart’, which query data and render a chart displaying that data.

Dashboards have 6 columns and as many rows as necessary to display their tiles.

* Additional properties are NOT allowed.
Show Child Parameters
labelsobject

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 “_”.

Example:{"env":"test"}

idstring(uuid)read-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

created_bystring(uuid)read-only

Contains a unique identifier used for this resource.

Example:5f9fd312-a987-4628-b4c5-bb4f4fddd5f7

created_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)read-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

get/dashboards/{dashboardId}
 
application/json