List the organization's autonomy zones

GET/api/public/v1/zones

Every live layer with its counts. Creates the organization's root unit and root zone on first call — the other trigger besides GET /org-units, through the same bootstrap.

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/zones' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/zones',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/zones' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/zones' -Headers $headers | ConvertTo-Json -Depth 20

Authorization

Role in the organization	This endpoint
`owner`	Allowed
`admin`	Allowed
`editor`	Allowed
`viewer`	Allowed

A key carries the role its owner holds in the organization. See Authentication.

API key scope: zones:read

Response

200 OK — the call succeeded.
401 Unauthorized — UNAUTHORIZED
402 Payment Required — license_expired
403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
429 Too Many Requests — TOO_MANY_REQUESTS
500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Response fields

Field	Type	Description
`data`	array of object	Required.
`data[].agents_compatibility_unavailable`	integer	Required.
`data[].agents_direct`	integer	Required.
`data[].agents_subtree`	integer	Required.
`data[].id`	string	Required.
`data[].is_default`	boolean
`data[].is_root`	boolean	Required.
`data[].org_unit_id`	string	Required.
`data[].path`	string	Required.
`data[].policies_in_force`	integer	Required.

Example response

{
  "data": [
    {
      "agents_compatibility_unavailable": 3,
      "agents_direct": 3,
      "agents_subtree": 3,
      "id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "is_default": false,
      "is_root": false,
      "org_unit_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "path": "Engineering / Platform",
      "policies_in_force": 3
    }
  ]
}