Planning
Get Product Supply Impact
Returns what extra ad-driven demand does to one product's supply, evaluated at the product's least-covered advertised inventory pool.
List Ad Demand Modifiers
Lists the active ad-sourced demand modifiers that the demand forecast currently includes. Each modifier comes from an active Growth, Launch or Liquidate product goal (or an approved ramp on one) and adds `uplift_per_day` units per day to the product's forecast between `start_date` and `end_date`. Modifiers whose `end_date` has passed are omitted; the set is rebuilt nightly from the goals still open.
List Budget Plans
Returns a paginated list of budget plans, newest month first (then newest ID first). Sorting is fixed; no `sort` parameter is accepted.
Create Budget Plan
Creates a monthly budget plan. Returns 201 with the plan. Creating a plan does not change any campaign budgets by itself; use Run Budget Allocation to spread it.
Get Budget Plan
Returns one budget plan. `month` is a date-only value (first day of the month).
Update Budget Plan
Replaces a budget plan's settings. Send the full plan: the same required fields as create apply.
Delete Budget Plan
Deletes a budget plan. Campaign budgets already changed by earlier allocator runs are not reverted.
Get Budget Plan Pacing
Returns the plan's pacing: plan vs actual spend vs projected month-end, in the tenant currency, through yesterday (today's spend is not reported yet).
Run Budget Allocation
Starts the budget allocator for the plan as a queued background job and returns its tracked job ID immediately. The allocator spreads the remaining daily target across the plan's live, budgeted campaigns (excluding `constraints.exclude_campaign_ids`), respecting the plan's constraints.
List Anomalies
Returns a paginated list of detected anomalies, most recent window first (then newest ID first). Sorting is fixed.
Get Anomaly
Returns one anomaly with its account, product and matched causes.
Snooze Anomaly
Hides an open anomaly from the decision feed until the end of the given day (tenant timezone). The anomaly keeps updating and still resolves on its own if the move ends; once the date passes it shows again if it is still open. Returns the updated anomaly with `snoozed_until`.
Dismiss Anomaly
Marks an anomaly as `dismissed`. No body. New anomalies on the same campaign, ad or keyword and metric are suppressed for 7 days (`dismissed_until`). Returns the updated anomaly. The `account_name`, `platform` and product SKU/name are not loaded in this response (they are null / only the product ID is returned).
List Experiments
Returns a paginated list of holdout experiments, newest first by default, with the size of each arm (`treatment_count`, `control_count`).
Create Experiment
Creates a holdout experiment and assigns products to treatment and control arms. Returns 201.
Get Experiment
Returns one experiment with its arm sizes. `starts_on` / `ends_on` are date-only values.
Stop Experiment
Stops a running or scheduled (draft) experiment now: status becomes `stopped`, `ends_on` is set to yesterday (or the start date), and the final results are computed and stored. No body. Returns 422 when the experiment is already stopped or completed.
Dismiss Experiment Result
Puts a finished experiment's result card away in the decision feed ('Not now'). The results stay on the experiment. No body. Returns the experiment with `result_dismissed_at` set.
Get Experiment Results
Returns the experiment's results: stored final results for a stopped or completed experiment, otherwise interim results computed now (`interim: true`).
Get Product Organic Halo
Returns a product's organic halo: weekly buckets (oldest first) through yesterday of total channel units, ad-attributed units, organic units (total - attributed, never below 0), paid share, ad spend, channel revenue and TACoS (spend / revenue), from orders on the sales channels the product is advertised on, plus window totals.