Routes

List all Routes

Changed on

List all Routes

get/v2/control-planes/{controlPlaneId}/core-entities/routes

Request

  • Base URL: https://global.api.konghq.com
  • URL: https://global.api.konghq.com/v2/control-planes/{controlPlaneId}/core-entities/routes
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Query parameters

sizeinteger

Number of resources to be returned.

offsetstring

Offset from which to return the next set of resources. Use the value of the 'offset' field from the response of a list operation as input here to paginate through all the resources

tagsstring

A list of tags to filter the list of resources on. Multiple tags can be concatenated using ',' to mean AND or using '/' to mean OR.

filter[name][contains]string

Filter routes by a substring of the name.

filter[name][eq]string

Filter routes by their name.

Response

A successful response listing Routes

nextstring

URI to the next page (may be null)

offsetstring

Offset is used to paginate through the API. Provide this value to the next list operation to fetch the next page

Example response

{
  "data": [
    {
      "hosts": [
        "foo.example.com",
        "foo.example.us"
      ],
      "id": "56c4566c-14cc-4132-9011-4139fcbbe50a",
      "name": "example-route",
      "paths": [
        "/v1",
        "/v2"
      ],
      "service": {
        "id": "bd380f99-659d-415e-b0e7-72ea05df3218"
      }
    }
  ]
}

Changes

  • c80d57ed14abRevision changes
    • info

      the response's property default value changed from http https to https for the status

    • info

      the response's property default value changed from http https to https for the status

  • 581456e3279fRevision changes
    • info

      added the new optional query request parameter filter[name][contains]

    • info

      added the new optional query request parameter filter[name][eq]