GET /api/ads-manager

Request	`GET /api/ads-manager`
Authentication	Session cookie required
Handler	`backend/server.py`

What it does

The stored campaign book, or an empty one with its next identifier and default settings. An account that has never saved a book gets the empty shape rather than a 404, so the client renders the same way either way.

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 \
  "https://flowfinds.ai/api/ads-manager"

const res = await fetch("https://flowfinds.ai/api/ads-manager", {
  method: "GET",
  credentials: "include",
});
const data = await res.json();

import requests

s = requests.Session()
r = s.get("https://flowfinds.ai/api/ads-manager")
data = r.json()

Recorded example

curl -s -b cookies.txt -c cookies.txt \
  "$FLOWFINDS_ORIGIN/api/ads-manager"

Responses

`200` — A book exists.

Field	Type	Description
`status`	`string`	`ok`.
`book`	`object`	`campaigns`, `next` and `settings`.
`updated_at`	`string`	When it was last saved.

`200` — No book has been saved.

Field	Type	Description
`status`	`string`	`ok`.
`book`	`object`	`campaigns: []`, `next: 1`, and default `settings`.

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/ad — The ad artifact for the session's product, with its pass criteria.
POST /api/ad/edit — Override the ad copy, or reset it to the generated version.
POST /api/growth/edit — Edit a growth artifact in natural language.
POST /api/ads-manager — Save the campaign book.
GET /api/adbalance — The advertising balance, its ledger and any pending top-ups.
POST /api/adbalance — Start a balance top-up.
GET /api/adbalance/confirm — Retired. Balance confirmation is no longer client-driven.
POST /api/organic/research — Research an organic campaign for named platforms.

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