Skip to content
Mengi CloudMengi Cloud Docs

Get Kubernetes Versions

GET
/versions/kubernetes/{provider}
curl --request GET \
  --url 'https://api.mengi.cloud/versions/kubernetes/example?include_deprecated=false'

Get supported Kubernetes versions for a provider.

Fetches versions from cloud provider APIs with 1-hour caching. Returns a list of versions sorted by recommendation order (default first).

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
provider
required
Provider
string

Query Parameters

Section titled “Query Parameters”
cluster_type
Any of:
string

Filter by cluster type: managed, talos, k3k

include_deprecated
Include Deprecated

Include deprecated versions

boolean

Include deprecated versions

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
KubernetesVersionListResponse

List of Kubernetes versions for a provider.

object
versions
required
Versions
Array<object>
KubernetesVersionResponse

Response schema for a Kubernetes version.

object
id
Any of:
string format: uuid
provider
required
Provider
string
cluster_type
required
Cluster Type
string
version
required
Version
string
patch_version
Any of:
string
display_name
Any of:
string
is_default
required
Is Default
boolean
is_deprecated
required
Is Deprecated
boolean
end_of_life_date
Any of:
string format: date-time
release_notes_url
Any of:
string
default_version
Any of:
string
Examplegenerated
{
  "versions": [
    {
      "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "provider": "example",
      "cluster_type": "example",
      "version": "example",
      "patch_version": "example",
      "display_name": "example",
      "is_default": true,
      "is_deprecated": true,
      "end_of_life_date": "2026-04-15T12:00:00Z",
      "release_notes_url": "example"
    }
  ],
  "default_version": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}