LiveLLM.Docs
API Reference · Control Plane

List proposals

List proposals

GET/v1/tenants/{name}/proposals

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 — Proposals, newest first.

proposalsarray
curl https://api.live-llm.com/v1/tenants/acme/proposals \
  -H "x-api-key: $LIVELLM_KEY"
Try itGEThttps://api.live-llm.com/v1/tenants/{name}/proposals
Fill required path param: name.
Example response200
{
  "proposals": [
    {
      "id": "prop_8f31ab",
      "workloadId": "vm-1",
      "kind": "drift",
      "op": "converge",
      "title": "vm-1 drifted from its machine state",
      "summary": "3 change(s) pending. Approving re-applies the blueprint.",
      "status": "pending",
      "createdAt": "2026-08-13T09:00:00Z"
    }
  ]
}