API Reference · Control Plane

List held resources

Resources where agent-initiated runs (loop fires, agent-to-agent dispatches, automatic fixes) are parked until released. Humans are never blocked by a hold.

GET/v1/tenants/{name}/holds

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.

Response

200 — Current holds.

holdsarray

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

Try itGEThttps://api.live-llm.com/v1/tenants/{name}/holds

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

name*

Fill required path param: name.

Example response200

{
  "holds": [
    {
      "workloadId": "vm-1",
      "reason": "vm-1 has drifted from its machine state \\u2014 3 change(s) pending",
      "createdAt": "2026-08-13T09:00:00Z"
    }
  ]
}