Skip to main content
GET
Get the Qovery Operator status for a cluster

Authorizations

Authorization
string
header
required

JWT tokens should be used with OIDC account (human to machine). JWT tokens used by the Qovery console to communicate with the API have a TTL. Curl Example ' curl https://console.qovery.com/organization -H "Authorization: Bearer $qovery_token" '

Path Parameters

organizationId
string<uuid>
required

Organization ID

clusterId
string<uuid>
required

Cluster ID

Response

Last reported Qovery Operator status

organization_id
string<uuid>
required
cluster_id
string<uuid>
required
operator_connected
boolean
required

Whether the last heartbeat is within the Operator presence window.

status
enum<string>
required

Stable fleet classification. OUTDATED_IMAGE and OUTDATED_CHART identify which globally selected bootstrap target differs from the version reported by the running Operator.

Available options:
NOT_ATTACHED,
DISCONNECTED,
TARGET_UNKNOWN,
REPORTED_VERSION_UNKNOWN,
CURRENT,
OUTDATED_IMAGE,
OUTDATED_CHART,
OUTDATED_IMAGE_AND_CHART
last_heartbeat
string<date-time> | null
operator_version
string | null

Display version reported by the Operator. For the POC version-reporting heartbeat, the official chart sets this to the exact installed image tag. Legacy Operators can report opaque build metadata instead.

controller_version
string | null
request_schema_version
string | null
desired_image_version
string | null

Image tag currently selected for a newly compiled Operator bootstrap.

desired_chart_version
string | null

Helm chart version currently selected for a newly compiled Operator bootstrap.

reported_chart_version
string | null

Helm chart version reported by the Operator, even without immutable identity.

reported_identity
object | null