---
title: "Discover Cluster Workloads"
method: GET
path: "/api/v1/clusters/{cluster_id}/workloads/discover"
tags: ["clusters"]
---

# Discover Cluster Workloads

`GET /api/v1/clusters/{cluster_id}/workloads/discover`

## Request

- Base URL: `https://api.mengi.cloud` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mengi.cloud/api/v1/clusters/{cluster_id}/workloads/discover`
- Auth: none declared

Discover running workloads in a cluster.

Scans the cluster for Helm releases and K8s workloads (Deployments,
StatefulSets, DaemonSets) and returns them for import selection.
Users may only scan imported clusters; the service principal (worker)
may scan any cluster, e.g. a migration target after a Velero restore.

## Path parameters

- `cluster_id` string, uuid, required

## Query parameters

- `namespace` string, nullable: Only return workloads in this namespace

## Response `200`

Successful Response

- DiscoveredWorkloadListResponse
  - `workloads` DiscoveredWorkload[], required
    - `name` string, required
    - `namespace` string, required
    - `kind` string, required
    - `helm_chart_name` string, nullable
    - `helm_chart_version` string, nullable
    - `custom_values_yaml` string, nullable
    - `helm_status` string, nullable
    - `docker_image` string, nullable
    - `replicas` integer, nullable
    - `cpu_request` number, nullable
    - `memory_request_mb` integer, nullable
    - `container_port` integer, nullable
    - `service_account_name` string, nullable
    - `selector_match_labels` object, nullable
    - `pod_template_labels` object, nullable
    - `manifest_yaml` string, nullable
    - `command` string[], nullable
    - `args` string[], nullable
    - `extra_pod_spec_yaml` string, nullable
    - `extra_container_spec_yaml` string, nullable
    - `is_helm_managed` boolean
    - `already_imported` boolean
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mengi/apis/mengi-cloud.md) · [All operations](https://skmtc.dev/mengi/apis/mengi-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/mengi/apis/mengi-cloud/revisions/4ae9b375cdbb?raw)