---
title: "Changes to Get an Upstream"
method: GET
path: "/v2/control-planes/{controlPlaneId}/core-entities/upstreams/{UpstreamId}"
---

# Changes to Get an Upstream

`GET /v2/control-planes/{controlPlaneId}/core-entities/upstreams/{UpstreamId}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 87 revisions.

- **2025-10-23** `8ab3ec3ed301`: 7 info
- **2025-08-22** `3c0154b2053a`: 8 breaking, 28 info
- **2025-08-14** `6333a0d3b095`: 1 breaking, 28 info
- **2025-07-22** `76b0fefddb0d`: 1 breaking, 1 warning, 29 info

## Changes

- **2025-10-23** `8ab3ec3ed301`: 7 info
  - the `active` response's property default value `{"concurrency":10,"healthy":{"http_statuses":[200,302],"interval":0,"successes":0},"http_path":"/","https_verify_certificate":true,"timeout":1,"type":"http","unhealthy":{"http_failures":0,"http_statuses":[429,404,500,501,502,503,504,505],"interval":0,"tcp_failures":0,"timeouts":0}}` was added for the status `200`
  - the `healthchecks` response's property default value `{"active":{"concurrency":10,"healthy":{"http_statuses":[200,302],"interval":0,"successes":0},"http_path":"/","https_verify_certificate":true,"timeout":1,"type":"http","unhealthy":{"http_failures":0,"http_statuses":[429,404,500,501,502,503,504,505],"interval":0,"tcp_failures":0,"timeouts":0}},"passive":{"healthy":{"http_statuses":[200,201,202,203,204,205,206,207,208,226,300,301,302,303,304,305,306,307,308],"successes":0},"type":"http","unhealthy":{"http_failures":0,"http_statuses":[429,500,503],"tcp_failures":0,"timeouts":0}}}` was added for the status `200`
  - the `healthy` response's property default value `{"http_statuses":[200,201,202,203,204,205,206,207,208,226,300,301,302,303,304,305,306,307,308],"successes":0}` was added for the status `200`
  - the `healthy` response's property default value `{"http_statuses":[200,302],"interval":0,"successes":0}` was added for the status `200`
  - the `passive` response's property default value `{"healthy":{"http_statuses":[200,201,202,203,204,205,206,207,208,226,300,301,302,303,304,305,306,307,308],"successes":0},"type":"http","unhealthy":{"http_failures":0,"http_statuses":[429,500,503],"tcp_failures":0,"timeouts":0}}` was added for the status `200`
  - the `unhealthy` response's property default value `{"http_failures":0,"http_statuses":[429,404,500,501,502,503,504,505],"interval":0,"tcp_failures":0,"timeouts":0}` was added for the status `200`
  - the `unhealthy` response's property default value `{"http_failures":0,"http_statuses":[429,500,503],"tcp_failures":0,"timeouts":0}` was added for the status `200`
- **2025-08-22** `3c0154b2053a`: 8 breaking, 28 info
  - the response property `healthchecks/active` became nullable for the status `200`
  - the response property `healthchecks/active/headers` became nullable for the status `200`
  - the response property `healthchecks/active/healthy` became nullable for the status `200`
  - the response property `healthchecks/active/https_sni` became nullable for the status `200`
  - the response property `healthchecks/active/unhealthy` became nullable for the status `200`
  - the response property `healthchecks/passive` became nullable for the status `200`
  - the response property `healthchecks/passive/healthy` became nullable for the status `200`
  - the response property `healthchecks/passive/unhealthy` became nullable for the status `200`
  - the `algorithm` response's property default value `round-robin` was added for the status `200`
  - the `concurrency` response's property default value `10` was added for the status `200`
  - the `hash_fallback` response's property default value `none` was added for the status `200`
  - the `hash_on` response's property default value `none` was added for the status `200`
  - the `hash_on_cookie_path` response's property default value `/` was added for the status `200`
  - the `http_failures` response's property default value `0` was added for the status `200`
  - the `http_failures` response's property default value `0` was added for the status `200`
  - the `http_path` response's property default value `/` was added for the status `200`
  - the `http_statuses` response's property default value `200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308` was added for the status `200`
  - the `http_statuses` response's property default value `200, 302` was added for the status `200`
  - the `http_statuses` response's property default value `429, 404, 500, 501, 502, 503, 504, 505` was added for the status `200`
  - the `http_statuses` response's property default value `429, 500, 503` was added for the status `200`
  - the `https_verify_certificate` response's property default value `true` was added for the status `200`
  - the `interval` response's property default value `0` was added for the status `200`
  - the `interval` response's property default value `0` was added for the status `200`
  - the `slots` response's property default value `10000` was added for the status `200`
  - the `sticky_sessions_cookie_path` response's property default value `/` was added for the status `200`
  - the `successes` response's property default value `0` was added for the status `200`
  - the `successes` response's property default value `0` was added for the status `200`
  - the `tcp_failures` response's property default value `0` was added for the status `200`
  - the `tcp_failures` response's property default value `0` was added for the status `200`
  - the `threshold` response's property default value `0` was added for the status `200`
  - the `timeout` response's property default value `1` was added for the status `200`
  - the `timeouts` response's property default value `0` was added for the status `200`
  - the `timeouts` response's property default value `0` was added for the status `200`
  - the `type` response's property default value `http` was added for the status `200`
  - the `type` response's property default value `http` was added for the status `200`
  - the `use_srv_name` response's property default value `false` was added for the status `200`
- **2025-08-14** `6333a0d3b095`: 1 breaking, 28 info
  - the `healthchecks/active/headers/additionalProperties/` response's property type changed from `string` to `array` for status `200`
  - the `algorithm` response's property default value `round-robin` was removed for the status `200`
  - the `concurrency` response's property default value `10` was removed for the status `200`
  - the `hash_fallback` response's property default value `none` was removed for the status `200`
  - the `hash_on` response's property default value `none` was removed for the status `200`
  - the `hash_on_cookie_path` response's property default value `/` was removed for the status `200`
  - the `http_failures` response's property default value `0` was removed for the status `200`
  - the `http_failures` response's property default value `0` was removed for the status `200`
  - the `http_path` response's property default value `/` was removed for the status `200`
  - the `http_statuses` response's property default value `200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308` was removed for the status `200`
  - the `http_statuses` response's property default value `200, 302` was removed for the status `200`
  - the `http_statuses` response's property default value `429, 404, 500, 501, 502, 503, 504, 505` was removed for the status `200`
  - the `http_statuses` response's property default value `429, 500, 503` was removed for the status `200`
  - the `https_verify_certificate` response's property default value `true` was removed for the status `200`
  - the `interval` response's property default value `0` was removed for the status `200`
  - the `interval` response's property default value `0` was removed for the status `200`
  - the `slots` response's property default value `10000` was removed for the status `200`
  - the `sticky_sessions_cookie_path` response's property default value `/` was removed for the status `200`
  - the `successes` response's property default value `0` was removed for the status `200`
  - the `successes` response's property default value `0` was removed for the status `200`
  - the `tcp_failures` response's property default value `0` was removed for the status `200`
  - the `tcp_failures` response's property default value `0` was removed for the status `200`
  - the `threshold` response's property default value `0` was removed for the status `200`
  - the `timeout` response's property default value `1` was removed for the status `200`
  - the `timeouts` response's property default value `0` was removed for the status `200`
  - the `timeouts` response's property default value `0` was removed for the status `200`
  - the `type` response's property default value `http` was removed for the status `200`
  - the `type` response's property default value `http` was removed for the status `200`
  - the `use_srv_name` response's property default value `false` was removed for the status `200`
- **2025-07-22** `76b0fefddb0d`: 1 breaking, 1 warning, 29 info
  - the response property `tags` became nullable for the status `200`
  - added the new `sticky-sessions` enum value to the `algorithm` response property for the response status `200`
  - added the optional property `sticky_sessions_cookie` to the response with the `200` status
  - added the optional property `sticky_sessions_cookie_path` to the response with the `200` status
  - the `algorithm` response's property default value `round-robin` was added for the status `200`
  - the `concurrency` response's property default value `10` was added for the status `200`
  - the `hash_fallback` response's property default value `none` was added for the status `200`
  - the `hash_on` response's property default value `none` was added for the status `200`
  - the `hash_on_cookie_path` response's property default value `/` was added for the status `200`
  - the `http_failures` response's property default value `0` was added for the status `200`
  - the `http_failures` response's property default value `0` was added for the status `200`
  - the `http_path` response's property default value `/` was added for the status `200`
  - the `http_statuses` response's property default value `200, 201, 202, 203, 204, 205, 206, 207, 208, 226, 300, 301, 302, 303, 304, 305, 306, 307, 308` was added for the status `200`
  - the `http_statuses` response's property default value `200, 302` was added for the status `200`
  - the `http_statuses` response's property default value `429, 404, 500, 501, 502, 503, 504, 505` was added for the status `200`
  - the `http_statuses` response's property default value `429, 500, 503` was added for the status `200`
  - the `https_verify_certificate` response's property default value `true` was added for the status `200`
  - the `interval` response's property default value `0` was added for the status `200`
  - the `interval` response's property default value `0` was added for the status `200`
  - the `slots` response's property default value `10000` was added for the status `200`
  - the `successes` response's property default value `0` was added for the status `200`
  - the `successes` response's property default value `0` was added for the status `200`
  - the `tcp_failures` response's property default value `0` was added for the status `200`
  - the `tcp_failures` response's property default value `0` was added for the status `200`
  - the `threshold` response's property default value `0` was added for the status `200`
  - the `timeout` response's property default value `1` was added for the status `200`
  - the `timeouts` response's property default value `0` was added for the status `200`
  - the `timeouts` response's property default value `0` was added for the status `200`
  - the `type` response's property default value `http` was added for the status `200`
  - the `type` response's property default value `http` was added for the status `200`
  - the `use_srv_name` response's property default value `false` was added for the status `200`

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-go-sdk/docs/v2/control-planes/:controlPlaneId/core-entities/upstreams/:UpstreamId/get.md) · [API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [Page](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v2/control-planes/:controlPlaneId/core-entities/upstreams/:UpstreamId/get)
