API Reference · Control Plane

Read a resource's agent-access mode

GET/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.

Response

200 — The mode, plus whether agent runs are currently held.

workloadIdstring

modeenum

One of: observe · suggest · auto.

heldboolean

holdReasonstring

curl https://api.live-llm.com/v1/tenants/acme/workloads/web/agent-access \
  -H "x-api-key: $LIVELLM_KEY"

Try itGEThttps://api.live-llm.com/v1/tenants/{name}/workloads/{id}/agent-access

API keyYour key stays in your browser (saved locally on this device) and is sent only to the API.

name*id*

Fill required path params: name, id.

Example response200

{
  "workloadId": "…",
  "mode": "observe",
  "held": false,
  "holdReason": "…"
}