POST /api/fix

Request	`POST /api/fix`
Authentication	No authentication
Handler	`backend/fixtool.py`

What it does

The entry point to Fix, the standalone tool. It takes a URL and returns a token and the page to watch. Fix requires no account: the token is the identity, and `POST /api/fix/adopt` attaches a completed run to an account afterwards.

Authentication

No authentication. The response does not depend on a session.

Parameters

Parameter	In	Type	Required	Description
`url`	body	`string`	Required	The store to examine.

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' \
  -d '{"url":"<string>"}' \
  "https://flowfinds.ai/api/fix"

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

import requests

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

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  -X POST -H 'Content-Type: application/json' \
  -d '{"url":"https://example.com"}' \
  "$FLOWFINDS_ORIGIN/api/fix"

Responses

`200` — The run started.

Field	Type	Description
`token`	`string`	The run identity.
`url`	`string`	`/fix/<token>` — the page that shows progress.

`200` — The URL was rejected.

Field	Type	Description
`error`	`string`	What was wrong with it.

Errors

This endpoint has no failure path of its own. An uncaught exception anywhere in the engine is still returned as structured JSON by the shared guard.

GET /api/fix/mine — The state of a Fix run, or this account's Fix subscriptions.
POST /api/fix/adopt — Attach a Fix run to this session.
POST /api/fix/event — Record an event or a piece of feedback against a Fix run.

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