Skip to main content
ZStack
Platform Operations/Platform Federation

GetDriftReport

Generate a configuration drift report comparing clusters against a base cluster.

GET/api/v1/federation/cluster-groups/{groupId}/drift-report

Operation ID

GetDriftReport

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • groupId
    StringRequired

    ID of the cluster group to generate a drift report for

Query Parameters

  • baseClusterId
    String

    UUID of the cluster to use as the comparison baseline UUID of the cluster to use as the comparison baseline

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • groupId
    String

    ID of the cluster group this drift report covers

    Example: cg-001-xyz

  • baseClusterId
    String

    UUID of the cluster used as the baseline for comparison

    Example: cluster-abc-001

  • driftItems
    List

    List of detected drift items

    Example: (nested array)

    • namespace
      String

      Namespace where drift was detected

      Example: production

    • workloadName
      String

      Name of the workload with detected drift

      Example: api-service

    • driftType
      String

      Type of drift detected (e.g. replicas, image, config)

      Example: replicas

    • baseValue
      String

      Value in the base cluster

      Example: 3

    • comparedValue
      String

      Value in the compared cluster

      Example: 2

    • compareCluster
      String

      ID of the cluster being compared against the base

      Example: cluster-secondary-001

  • generatedAt
    String

    Generated at

    Example: 2026-01-15T08:00:00Z