POST /api/ai/edit

What it does

Hands a message to the editor and reports exactly what changed. The interesting responses are the failures: `no_change` means nothing was modified; `partial_edit` means changes remain in the draft and must be reviewed or undone before retrying, rather than being silently rolled forward; `editor_unavailable` carries the editor's own stderr, truncated, instead of a generic apology. `changed` is the list of fields actually modified, so a client never has to diff to find out.

Authentication

Session cookie required. Send the ff_session cookie. Without one the engine treats the caller as a new visitor with no holds and no claims, and returns a new cookie to use from then on.

Parameters

Request

The cookie jar carries the session between calls. Angle-bracketed values are the parameter types from the table above.

curl -s -b cookies.txt -c cookies.txt \
  -X POST -H 'Content-Type: application/json' \
  -d '{"message":"<string>","product_id":"<string>"}' \
  "https://flowfinds.ai/api/ai/edit"

const res = await fetch("https://flowfinds.ai/api/ai/edit", {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "message": "<string>",
    "product_id": "<string>"
  }),
});
const data = await res.json();

import requests

s = requests.Session()
r = s.post("https://flowfinds.ai/api/ai/edit", json={
    "message": "<string>",
    "product_id": "<string>"
  })
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  -X POST -H 'Content-Type: application/json' \
  -d '{"message":"Make the hero headline shorter.","product_id":"…"}' \
  "$FLOWFINDS_ORIGIN/api/ai/edit"

Responses

Errors

Related

• GET /api/store — The state of the session's storefront.
• POST /api/store — Start generating the storefront for the session's product.
• POST /api/store/publish — Verify and publish the storefront, regenerating it if verification demands.
• POST /api/intent — Ask the engine what it would change on a surface, and why.
• POST /api/intent/apply — Apply a proposed intent, regenerating the store.
• POST /api/intent/order — Override the section the storefront leads with.
• POST /api/intent/revert — Undo the last applied intent.
• GET /api/editor/ — Read editor state and store metrics.

Back to the API reference index, or read the cookbook for recipes that compose this endpoint with others.