Choose which chat the preview shows live
show_live_changes
Picks the running chat whose unfinished changes the preview shows on top of the merged site, or shows the merged site alone.
Each chat works in its own copy of the site. While chats run, the preview shows the merged site plus the unfinished changes of one running chat, and list_chats names that chat in live. This is the button on the preview's address bar that reads Live: Pricing page or Merged site only. See The live preview.
Pass the chatId of a running chat to show its changes, or leave chatId out to show the merged site only until no chat is running. The preview is shared, so this changes it for everyone who has the site open. Anyone in the workspace can use it.
The response carries live, the chat now shown, or null for the merged site only.
| Status | When | The message |
|---|---|---|
409 |
The site does not work with several chats yet | This site has no chat changes to show live yet! |
409 |
The chat has no changes to show yet | This chat has no changes to show live yet! |
409 |
The preview is not connected yet, which is safe to try again in a moment | The preview is not ready to show live changes right now. Try again in a moment! |
409 |
The preview could not switch, which is safe to try again in a moment | The preview could not switch its live changes. Try again in a moment! |
404 |
The chat is not open | That chat was not found! |
503 |
The preview did not answer in time, which is safe to try again in a moment | The preview did not answer in time. Try again in a moment! |
Request
Call it with a POST to https://api.modulify.ai/v1/show_live_changes, sending the inputs below as a JSON object. The token needs the chat:write scope.
It makes changes, so send an Idempotency-Key header whenever you might retry it. A retry with the same key gets the first answer back instead of running again.
curl -X POST https://api.modulify.ai/v1/show_live_changes \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"projectId":"PROJECT_ID"}'Over MCP, the same method is the show_live_changes tool.
Inputs
| Input | Type | Required | Description |
|---|---|---|---|
projectId |
string | Yes | The site id, from list_sites or get_site. |
chatId |
string | No | The chatKey of a running chat from list_chats whose changes the preview should show. Leave it out to show the merged site only. |
Response
Every call answers with the JSON envelope of success, message, data, code and version. data holds the result described above, and on a method that returns a total, count carries it. The response headers carry the call's X-Request-Id and what is left of your per-minute budget in X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Errors explains every status code a call can answer with.