---
title: "List all workloads in a specified cluster"
method: GET
path: "/clusters/{cluster_uid}/workloads"
tags: ["Workloads"]
---

# List all workloads in a specified cluster

`GET /clusters/{cluster_uid}/workloads`

## Request

- Base URL: `https://api.app.perfectscale.io/public/v1`
- URL: `https://api.app.perfectscale.io/public/v1/clusters/{cluster_uid}/workloads`
- Auth: HTTP bearer

## Path parameters

- `cluster_uid` string, required

## Response `200`

A list of workloads

- object
  - `meta` object, required
    - `count` integer, required: The total number of workloads in the specified cluster.
  - `data` Workload[], required
    - `id` string, required: A unique identifier for the workload, usually following a namespace-type-name convention.
    - `name` string, required: A human-readable name for the workload.
    - `type` string, required: The type of Kubernetes workload. Common types include Deployment, StatefulSet, and DaemonSet, but other string values can also be used to represent custom or extended workload types.
    - `namespace` string, required: The Kubernetes namespace in which the workload resides.
    - `firstSeen` string, date-time, required: The timestamp when the workload was first observed, formatted as an ISO 8601 date-time string.
    - `lastSeen` string, date-time, required: The timestamp when the workload was last observed, formatted as an ISO 8601 date-time string.
    - `runningMinutes` integer, required: The total number of minutes the workload has been running.
    - `replicasCounts` ReplicasCounts, required: An object representing the count statistics of replicas for a workload over a month period.
      - `maxCount` integer, required: The maximum count of replicas observed for the workload during the month period.
      - `avgCount` integer, required: The average count of replicas observed for the workload during the month period.
    - `resilienceLevel` 'low' | 'medium' | 'high' | 'highest', required: The resilience level of the workload, indicating its tolerance to failures or disruptions (configured on Perfectscale side).
    - `muteStatus` MuteStatus, required: The mute status of a workload, indicating whether the workload is currently muted and when it will become unmuted.
      - `isMuted` boolean, required: Indicates whether the workload is currently muted.
      - `muteExpiry` string, date-time: The date and time when the workload will automatically become unmuted. If null, the mute status does not expire automatically.
    - `costAnalysis` CostAnalysis, required: Analysis of the costs associated with the workload's resource consumption over the past 30 days and projected for the next 30 days.
      - `past30Days` Past30DaysCostAnalysis, required: Metrics detailing the total and wasted costs associated with the workload's resource consumption.
        - `totalCost` number, double, required: The total cost incurred by the workload's resource consumption.
        - `wastedCost` number, double, required: The cost attributed to over-provisioned or inefficiently utilized resources.
      - `costIncrease` number, double, required: The increased cost associated with the workload.
    - `workloadLabels` object, required: Key-value pairs representing kubernets labels associated with the workload.
    - `indicators` Indicator[], required: A list of indicators providing insights into the performance and health of the workload.
      - `name` 'OOM' | 'CpuThrottling' | 'CpuRequestNotSet' | 'MemRequestNotSet' | 'MemLimitNotSet' | 'UnderProvisionedMemRequest' | 'UnderProvisionedMemLimit' | 'UnderProvisionedCpuRequest' | 'UnderProvisionedCpuLimit' | 'OverProvisionedCpuRequest' | 'OverProvisionedMemRequest' | 'RestartsObserved', required: The name of the indicator representing a specific aspect of performance or health.
      - `type` 'none' | 'risk' | 'waste', required: The type of indicator, categorizing it as either a risk, waste, or no issue (none).
      - `severityLevel` 0 | 1 | 2 | 3, required: The severity level of the indicator, ranging from 0 (no issue) to 3 (critical issue).
    - `containers` object, required: An object holding detailed information about each container within the workload.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Cluster not found
- `500`: Internal server error

## Changes

- **2026-11-03** `7a20a9387224`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/perfectscale/apis/perfectscale-api-openapi-3-0/changes/clusters/:cluster_uid/workloads/get.md)

---

[API](https://skmtc.dev/perfectscale/apis/perfectscale-api-openapi-3-0.md) - [All operations](https://skmtc.dev/perfectscale/apis/perfectscale-api-openapi-3-0/llms.txt) - [OpenAPI document](https://skmtc.dev/perfectscale/apis/perfectscale-api-openapi-3-0/revisions/7a20a9387224?raw)