Skip to main content
ZStack
Monitoring & Collection/Zaku

GetCluster

Retrieve a single Kubernetes cluster by its UUID

GET/api/v1/zaku/clusters/{uuid}

Operation ID

GetCluster

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

  • uuid
    StringRequired

    UUID of the cluster to retrieve

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier of the cluster

    Example: cluster-abc123

  • platformId
    String

    Platform ID this cluster belongs to

    Example: plat-001

  • zakuId
    String

    Internal Zaku numeric identifier

    Example: 42

  • name
    String

    Human-readable cluster name

    Example: prod-k8s-cluster-01

  • status
    String

    Current operational status of the cluster

    Example: Running

  • description
    String

    Optional description of the cluster

    Example: Production Kubernetes cluster for AI workloads

  • nodeCount
    Integer

    Total number of nodes in this cluster

    Example: 12

  • createDate
    String

    Timestamp when the cluster was registered

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

  • lastSyncAt
    String

    Timestamp of the last successful sync

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

  • syncStatus
    String

    Status of the last synchronization attempt

    Example: Success

  • lastSyncError
    String

    Error message from the last failed sync, if any

    Example: connection refused

  • syncDurationMs
    String

    Duration of the last sync operation in milliseconds

    Example: 350