API Reference · Control Plane

Approve a proposal

Executes the proposal's operation — apply the patched spec, delete the resource, or converge a drifted machine — then resolves it and releases any hold it set. Owner-only: an agent cannot approve its own proposal.

POST/v1/tenants/{name}/proposals/{id}/approve

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

Response

200 — The resolved proposal.

idstring

workloadIdstring

kindenum

One of: incident · drift · cost · change.

openum

What approving executes \u2014 apply the patch, delete the resource, converge the machine, or just acknowledge.

titlestring

summarystring

patchobject

op=update: the full desired workload JSON.

diffstring

Pre-rendered diff / check output for review.

verifystring

statusenum

One of: pending · approved · rejected.

createdBystring

taskIdstring

createdAtstring · date-time

resolvedAtstring · date-time

notestring

Resolution note.

curl -X POST https://api.live-llm.com/v1/tenants/acme/proposals/web/approve \
  -H "x-api-key: $LIVELLM_KEY"

Try itPOSThttps://api.live-llm.com/v1/tenants/{name}/proposals/{id}/approve

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

{
  "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"
}