---
title: "Get tenant resource tree"
method: GET
path: "/tenants/{tenant_id}/structure"
tags: ["Tenants"]
---

# Get tenant resource tree

`GET /tenants/{tenant_id}/structure`

Returns the entire tenant resource hierarchy as a nested tree: divisions -> environments -> deployments. Single call to prime an agent's context about everything in the tenant. Permission-filtered, hidden divisions and environments are omitted. Each deployment's `supervisor_url` points to the supervisor API that owns its lifecycle (status, configuration, telemetry, restart, upgrade, node operations).

## Path parameters

- `tenant_id` integer, required

## Response `200`

Tenant resource tree

- TenantStructure
  - `divisions` DivisionStructure[], required
    - `environments` EnvironmentStructure[], required
      - `deployments` DeploymentStructure[], required
        - `cloud` 'aws' | 'gcp', required — Supported managed cloud provider. Only `aws` and `gcp` are accepted on the public API.
        - `id` integer, required
        - `name` string, required
        - `region` string
        - `supervisor_url` string, nullable — Base URL of the supervisor API that owns this deployment's lifecycle. All status, configuration, telemetry, restart, upgrade, and node operations target this host: see the Supervisor API reference. Absent for `on_premise` deployments that are not fronted by a managed supervisor.
        - `tier` 'free' | 'small' | 'medium' | 'large' | 'xlarge' | '2xlarge' | '4xlarge' | '8xlarge' | '16xlarge'
        - `variant` 'managed' | 'byoc' | 'on_premise', required
      - `id` integer, required
      - `name` string, required
    - `id` integer, required
    - `name` string, required
  - `id` integer, required
  - `name` string, required

## Other responses

- `403` — Not a member of the tenant

---

[API](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api.md) · [All operations](https://skmtc.net/laserdata/apis/laserdata-cloud-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/laserdata/laserdata-cloud-core-api/revisions/db81a447bba9/schema)