Ce qui s’applique à cet agent

GET/api/public/v1/agents/{agent_id}/zone

The assigned zone, how it was assigned, the layer stack top-down, and every effective policy with the layer that authored it and whether that layer is the agent's own (authored_here / inherited). Resolved by app/zones/resolution.py — the one implementation every zone surface shares.

cURL

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

Python

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/zone',
    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)

Bash

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

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

PowerShell

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

Autorisation

Rôle dans l’organisation	Ce point de terminaison
owner	Autorisé
admin	Autorisé
editor	Autorisé
viewer	Autorisé

Une clé porte le rôle que son propriétaire détient dans l’organisation. Voir Authentification.

Portée de clé d’API : zones:read

Paramètres de chemin

Paramètre	Type	Description
agent_id	string	Obligatoire.

Réponse

• 200 OK — l’appel a réussi.
• 401 Unauthorized — UNAUTHORIZED
• 402 Payment Required — license_expired
• 403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
• 404 Not Found — NOT_FOUND
• 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 — ENGINE_UNAVAILABLE, FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Champs de la réponse

Champ	Type	Description
assigned_zone	string or null	Obligatoire.
assignment_source	string	Obligatoire.
capabilities	object or null
capabilities.ask	boolean	Obligatoire. Can show its own prompt to the developer.
capabilities.enforces	string	Obligatoire. all, or shell_only: which tools its refusals actually reach.
capabilities.notice	boolean	Obligatoire. Can show a non-blocking message.
capabilities.observes_execution	boolean	Obligatoire. Emits a post-execution event, so an answer can be inferred.
client	object	Obligatoire. What the install last told us about itself.
client.bundle_revision	string or null
client.omitted_kinds	array of string	Obligatoire.
client.version	string or null
compatibility	object	Obligatoire. Per-family compatibility posture for one install, keyed by contract family.
compatibility.families	object	Obligatoire.
control_level	string	Obligatoire.
effective	array of object	Obligatoire.
effective[].dimensions	array of string	Obligatoire.
effective[].display_title	string	The AIP's name: its title, else its generated_title, else its statement.
effective[].enforced_on_this_install	boolean	Obligatoire.
effective[].mode	string	Obligatoire.
effective[].optimize	array of object
effective[].optimize_preview	array of object
effective[].origin_layer_id	string	Obligatoire.
effective[].origin_layer_label	string	Obligatoire.
effective[].policy_id	string	Obligatoire.
effective[].public_id	string	Obligatoire.
effective[].standing	string	Obligatoire.
effective[].statement	string	Obligatoire.
kpis	object	Obligatoire.
kpis.anomalies_14d	integer
kpis.authored_here	integer	Obligatoire.
kpis.enforcing_n	integer	Obligatoire.
kpis.enforcing_of	integer	Obligatoire.
kpis.inherited	integer	Obligatoire.
kpis.policies_in_force	integer	Obligatoire.
layers	array of object	Obligatoire.
layers[].depth	integer	Obligatoire.
layers[].label	string	Obligatoire.
layers[].unit_id	string	Obligatoire.
stale	boolean	Obligatoire.

Exemple de réponse

{
  "assigned_zone": "string",
  "assignment_source": "string",
  "capabilities": {
    "ask": false,
    "enforces": "string",
    "notice": false,
    "observes_execution": false
  },
  "client": {
    "bundle_revision": "string",
    "omitted_kinds": [
      "string"
    ],
    "version": "string"
  },
  "compatibility": {
    "families": {}
  },
  "control_level": "string",
  "effective": [
    {
      "dimensions": [
        "string"
      ],
      "display_title": "",
      "enforced_on_this_install": false,
      "mode": "string",
      "optimize": [
        {
          "atom_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
          "directive": {
            "lever": "effort_clamp",
            "params": {}
          }
        }
      ],
      "optimize_preview": [
        {}
      ],
      "origin_layer_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "origin_layer_label": "string",
      "policy_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "public_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10",
      "standing": "string",
      "statement": "string"
    }
  ],
  "kpis": {
    "anomalies_14d": 0,
    "authored_here": 3,
    "enforcing_n": 3,
    "enforcing_of": 3,
    "inherited": 3,
    "policies_in_force": 3
  },
  "layers": [
    {
      "depth": 3,
      "label": "string",
      "unit_id": "3f6c1a2e-8b4d-4c1f-9a7e-0d5b2c8e4f10"
    }
  ],
  "stale": false
}

Voir aussi

• DELETE Rétablir l’affectation automatique de zone d’un agent
• PUT Affecter un agent à une zone à la main
• GET Lister les unités organisationnelles de l’organisation