Routes

Create or Update Route using ID or name.

put/v2/control-planes/{controlPlaneId}/core-entities/routes/{RouteId}

Request

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

Request body

OR

Example request

{
  "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"
  }
}

Response

Successfully upserted Route

OR

Example response

{
  "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

    • info

      the request property default value changed from http https to https

    • info

      the request property default value changed from http https to https

    • 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

    • breaking

      the request property ////// became not nullable

    • breaking

      the request property ////// became not nullable

    • breaking

      the request property ////// became not nullable

    • breaking

      the request property ////// became not nullable