# List resource tree — GET /v1/deploy/applications/{name}/resource-tree URL: https://docs.hanzo.ai/docs/openapi/deploy/get-deploy-applications-by-name-resource-tree > Returns one application's argocd ApplicationTree: the objects the operator reconciled from its App CR, reached by ownerRef — the Deployment and, under it, the ReplicaSet and Pods, plus the Service, Ingress, HorizontalPodAutoscaler, PodDisruptionBudget and ConfigMaps it owns — each node carrying its parent edges and its health. `GET /v1/deploy/applications/{name}/resource-tree` > [Deploy →](https://docs.hanzo.ai/docs/openapi/deploy) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | ------------------------------------------------------------------ | | **Address** | `https://api.hanzo.ai/v1/deploy/applications/{name}/resource-tree` | | **Method** | `GET` | | **Operation** | `get_deploy_applications_by_name_resource-tree` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Returns one application's argocd ApplicationTree: the objects the operator reconciled from its App CR, reached by ownerRef — the Deployment and, under it, the ReplicaSet and Pods, plus the Service, Ingress, HorizontalPodAutoscaler, PodDisruptionBudget and ConfigMaps it owns — each node carrying its parent edges and its health. Secrets are DELIBERATELY not walked, so no materialized environment can ever appear in the tree. Tenant-scoped exactly like the application read: another org's name is not found, a malformed name is a 400. ## Request 1 field. | Field | In | Type | Required | Description | | ------ | ---- | ------ | -------- | ----------------------------------------------- | | `name` | path | string | yes | Name is the application to read, from the path. | ## Response | Status | Body | Meaning | | --------- | --------------- | ------- | | `200` | deploy.argoTree | ok | | `default` | problem-details | refused | `200` body — 47 fields. | Field | In | Type | Always | Description | | ---------------------------------------- | ---- | ------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `hosts` | body | any\[] | — | Hosts is ArgoCD's per-node machine inventory. | | `nodes` | body | deploy.argoNode\[] | — | Nodes is the FLAT node list, root first: the App CR, then the objects the operator owns, then their ReplicaSets and Pods. | | `nodes[].createdAt` | body | string | — | CreatedAt is the object's creationTimestamp, RFC 3339 UTC to the second. | | `nodes[].group` | body | string | — | | | `nodes[].health` | body | deploy.argoHealth | — | | | `nodes[].health.message` | body | string | — | Message is why the status is what it is — "Running: no replicas ready", "iam: CrashLoopBackOff". | | `nodes[].health.status` | body | string | — | Status is the ArgoCD health vocabulary, Capitalized: Healthy, Progressing, Degraded, Suspended, Missing or Unknown. | | `nodes[].images` | body | string\[] | — | Images are the container images running on this node. | | `nodes[].info` | body | deploy.argoInfoItem\[] | — | Info are the chips shown on the node. | | `nodes[].info[].name` | body | string | — | Name is the chip's label. | | `nodes[].info[].value` | body | string | — | Value is the chip's value — for "Image Tag", the tag the node runs. | | `nodes[].kind` | body | string | — | | | `nodes[].name` | body | string | — | | | `nodes[].namespace` | body | string | — | | | `nodes[].parentRefs` | body | deploy.argoResourceRef\[] | — | ParentRefs are the node's edges UPWARD, which is how the SPA draws the DAG from this flat list. | | `nodes[].parentRefs[].group` | body | string | — | Group is the object's API group: empty for the core group (Pod, Service, ConfigMap), otherwise apps, networking.k8s.io, autoscaling or policy — and hanzo.ai for the App CR at the root. | | `nodes[].parentRefs[].kind` | body | string | — | Kind is the object kind. | | `nodes[].parentRefs[].name` | body | string | — | Name is the object's metadata.name. | | `nodes[].parentRefs[].namespace` | body | string | — | Namespace is the namespace the walk ran in, the same for every node of one tree. | | `nodes[].parentRefs[].uid` | body | string | — | UID is the object's metadata.uid. | | `nodes[].parentRefs[].version` | body | string | — | Version is the object's API version as the live object reports it: v1 for every kind the walk reaches except the HorizontalPodAutoscaler, which is autoscaling/v2. | | `nodes[].resourceVersion` | body | string | — | ResourceVersion is the k8s version a watch would resume from. | | `nodes[].uid` | body | string | — | | | `nodes[].version` | body | string | — | | | `orphanedNodes` | body | deploy.argoNode\[] | — | OrphanedNodes are objects in the namespace belonging to no application. | | `orphanedNodes[].createdAt` | body | string | — | CreatedAt is the object's creationTimestamp, RFC 3339 UTC to the second. | | `orphanedNodes[].group` | body | string | — | | | `orphanedNodes[].health` | body | deploy.argoHealth | — | | | `orphanedNodes[].health.message` | body | string | — | Message is why the status is what it is — "Running: no replicas ready", "iam: CrashLoopBackOff". | | `orphanedNodes[].health.status` | body | string | — | Status is the ArgoCD health vocabulary, Capitalized: Healthy, Progressing, Degraded, Suspended, Missing or Unknown. | | `orphanedNodes[].images` | body | string\[] | — | Images are the container images running on this node. | | `orphanedNodes[].info` | body | deploy.argoInfoItem\[] | — | Info are the chips shown on the node. | | `orphanedNodes[].info[].name` | body | string | — | Name is the chip's label. | | `orphanedNodes[].info[].value` | body | string | — | Value is the chip's value — for "Image Tag", the tag the node runs. | | `orphanedNodes[].kind` | body | string | — | | | `orphanedNodes[].name` | body | string | — | | | `orphanedNodes[].namespace` | body | string | — | | | `orphanedNodes[].parentRefs` | body | deploy.argoResourceRef\[] | — | ParentRefs are the node's edges UPWARD, which is how the SPA draws the DAG from this flat list. | | `orphanedNodes[].parentRefs[].group` | body | string | — | Group is the object's API group: empty for the core group (Pod, Service, ConfigMap), otherwise apps, networking.k8s.io, autoscaling or policy — and hanzo.ai for the App CR at the root. | | `orphanedNodes[].parentRefs[].kind` | body | string | — | Kind is the object kind. | | `orphanedNodes[].parentRefs[].name` | body | string | — | Name is the object's metadata.name. | | `orphanedNodes[].parentRefs[].namespace` | body | string | — | Namespace is the namespace the walk ran in, the same for every node of one tree. | | `orphanedNodes[].parentRefs[].uid` | body | string | — | UID is the object's metadata.uid. | | `orphanedNodes[].parentRefs[].version` | body | string | — | Version is the object's API version as the live object reports it: v1 for every kind the walk reaches except the HorizontalPodAutoscaler, which is autoscaling/v2. | | `orphanedNodes[].resourceVersion` | body | string | — | ResourceVersion is the k8s version a watch would resume from. | | `orphanedNodes[].uid` | body | string | — | | | `orphanedNodes[].version` | body | string | — | | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo deploy applications resource-tree ``` **SDK** **.ts** ```ts import { Configuration, DeployApi } from 'hanzoai'; const api = new DeployApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.getDeployApplicationsByNameResource-tree({ name: 'name' }); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import DeployApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = DeployApi(client).get_deploy_applications_by_name_resource-tree(name='name') ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.DeployAPI.GetDeployApplicationsByNameResource-tree(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, deploy_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = deploy_api::get_deploy_applications_by_name_resource-tree(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.DeployApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new DeployApi(client).getDeployApplicationsByNameResource-tree(); ``` The method above is the one at the current release of the document. `hanzoai@8.5.914` (npm) and `hanzoai@8.5.914` (PyPI) were generated from an earlier release, where this operation carried a different id, so it spells the method differently — regenerating the clients is what makes the two agree. [SDKs →](https://docs.hanzo.ai/docs/sdks) **HTTP** ```bash curl https://api.hanzo.ai/v1/deploy/applications//resource-tree \ -H "Authorization: Bearer $HANZO_API_KEY" ``` **MCP** MCP reaches **deploy** through the `deploy` tool, which names its 11 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them: ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "describe", "arguments": { "op": "list_deploy_applications" } } }' ``` --- [Deploy API](https://docs.hanzo.ai/docs/openapi/deploy) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)