Tenants

Get tenant resource tree

Returns the part of the tenant resource hierarchy that the caller may read, as a nested tree: divisions -> environments -> deployments. An environment appears when the caller holds any grant in it. A division appears when the caller can read it, or when it holds an environment that appears. Deployments appear only in environments where the caller has deployment:read, so an environment can appear with an empty deployment list. Each deployment's supervisor_url points to the supervisor API that owns its lifecycle (status, configuration, telemetry, restart, upgrade, node operations).

get/tenants/{tenant_id}/structure

Request

  • Base URL
    https://api.laserdata.cloud
  • Auth
    • API key in header ld-api-key
    • or API key in cookie session

Path parameters

tenant_idinteger required
Example:7261845022003200000

Tenant identifier

Response

Tenant resource tree

idinteger required
namestring required

Example response

{
  "divisions": [
    {
      "environments": [
        {
          "deployments": [
            {
              "cloud": "aws",
              "id": 7261845127892140000,
              "name": "iggy-prod-01",
              "region": "us-east-1",
              "supervisor_url": "https://supervisor-aws-us.laserdata.cloud"
            }
          ],
          "id": 7261845066528310000,
          "name": "staging"
        }
      ],
      "id": 7261844974723780000,
      "name": "production"
    }
  ],
  "id": 7261845022003200000,
  "name": "acme-corp"
}

Changes

No recorded changes to this operation across all 7 revisions of this API.