POST /api/store/publish

Request	`POST /api/store/publish`
Authentication	Session cookie required
Handler	`backend/server.py`

What it does

Publishing verifies the store before it confirms it. When verification forces a rewrite, `regenerated` is true — a publish that had to rewrite the store did more than confirm it, and the founder is told which of the two happened rather than being shown one word for both.

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

Parameter	In	Type	Required	Description
`ff_session`	cookie	`string`	Optional	The session identifier. Omit it on the first call and store the value the response sets; every later call must send the same one or the engine treats the caller as a new visitor with no holds and no claims.

Request

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

cURLJavaScriptPython

curl -s -b cookies.txt -c cookies.txt \
  -X POST -H 'Content-Type: application/json' \
  "https://flowfinds.ai/api/store/publish"

const res = await fetch("https://flowfinds.ai/api/store/publish", {
  method: "POST",
  credentials: "include",
});
const data = await res.json();

import requests

s = requests.Session()
r = s.post("https://flowfinds.ai/api/store/publish")
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  -X POST -H 'Content-Type: application/json' \
  -d '{}' \
  "$FLOWFINDS_ORIGIN/api/store/publish"

Responses

`200` — Publication completed.

Field	Type	Description
`status`	`string`	The manifest's status after publishing.
`product_id`	`string`	The product.
`verification`	`object`	The verification result the decision was made on.
`regenerated`	`boolean`	True when the store had to be rewritten to pass verification.
`browsable_path`	`string`	The path that resolves to the published store.

Errors

Status	Reason	When
`409`	`build_in_progress`	A build is already running for this product.
`500`	`generation_failed`	The regeneration raised.

GET /api/store — The state of the session's storefront.
POST /api/store — Start generating the storefront for the session's product.
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.
POST /api/ai/edit — Edit the storefront in natural language.
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.