API Reference · Control Plane

Set a resource's agent-access mode

`observe` — agents read and report, never change it. `suggest` — every agent change converts into a proposal. `auto` (default) — agents may change it; destructive actions (delete, disk erase, restore-point operations) always escalate regardless of mode. Owner-only.

PUT/v1/tenants/{name}/workloads/{id}/agent-access

Authorization

x-api-keystringrequired
Your per-workspace API key, e.g. llc_AbC123…. Also accepted as Authorization: Bearer <key>. Mint keys on your workspace's API keys page — each key belongs to one workspace.

Path parameters

namestringrequired
Workspace (tenant) name.
idstringrequired
Workload id within the workspace.

Body

modeenumrequired
One of: observe · suggest · auto.

Response

200Saved.

curl -X PUT https://api.live-llm.com/v1/tenants/acme/workloads/web/agent-access \
  -H "x-api-key: $LIVELLM_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "observe"
  }'
Try itPUThttps://api.live-llm.com/v1/tenants/{name}/workloads/{id}/agent-access
Fill required path params: name, id.
Example response200
Saved.