`request_changes`

Editorial write

What it does

Flips an item to Da modificare (Italian: to be revised) so the editor knows it needs another pass. Optional comment is echoed back in the response — future versions will surface it as a workspace activity entry.

Input schema

Name	Type	Required	Default	Description
id	string	required	`—`	Content id.
comment	string	optional	`—`	Optional revision note for the editor.

Example call

json{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "request_changes",
    "arguments": {
        "id": "c_abc123",
        "comment": "Hook is too long — trim to 2 seconds."
    }
  }
}

Response shape

json{
  "ok": true,
  "id": "c_abc123",
  "new_stato": "Da modificare",
  "comment": "Hook is too long — trim to 2 seconds."
}

Usage from Claude Desktop

prompt"Send c_abc123 back to editing with a note that the hook is too long."

Usage from Python

pythonimport requests

LUMIQA = "https://lumiqa.io/mcp/your-slug"
HEADERS = {"Authorization": "Bearer lk_live_xxxxxxxxxxxx"}

r = requests.post(LUMIQA, headers=HEADERS, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "tools/call",
    "params": {
        "name": "request_changes",
        "arguments": {"id": "c_abc123", "comment": "Trim the hook"}
    },
})
print(r.json())

Usage from Node

javascriptconst r = await fetch("https://lumiqa.io/mcp/your-slug", {
  method: "POST",
  headers: {
    "Authorization": "Bearer lk_live_xxxxxxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    jsonrpc: "2.0", id: 1,
    method: "tools/call",
    params: {
      name: "request_changes",
      arguments: { id: "c_abc123", comment: "Trim the hook" },
    },
  }),
});
const data = await r.json();
console.log(data);

Required env vars / integrations

None — D1 only.

Known limitations

The comment is returned in the response but not yet persisted to a comments table — durable change-request history is on the v1.1 roadmap.
Requires a write scope key.

request_changes