Guardrails
List Ad Health Products
Lists advertised products with their ad health: the worst stock-cover pool across ad accounts, inbound supply, forecast, break-even ACoS, 7- and 30-day spend / ACoS / TACoS / POAS, overall `health`, open guardrail signals, active holds, a per-platform breakdown and the product's live ad items. Only products with a health snapshot (that is, products evaluated by the guardrails) are listed.
Get Ad Health Product
Returns one product's ad health: every field of the list row, plus whether it is exempt from guardrails (`exempt`, `exempt_reason`), a per-account breakdown (`accounts`: the raw evaluation `inputs`, including `on_hand_cover_days`, the days the stock on hand lasts with no inbound (for a bundle, its scarcest component at that component's own demand), where each input came from, and the effective guardrail policy mode with the policies that supplied it), its guardrail `signal_history`, its ad `change_history`, and a `timeline` of daily stock, projected stock (available minus forecast plus inbound as it lands), forecast, spend and POAS from 30 days back to 60 days ahead, with the pause/resume thresholds in days and units and inbound purchase order markers.
Update Ad Health Product Exemption
Exempts a product from ad guardrails, or removes the exemption. An exempt product raises no guardrail signals from the next evaluation on; existing signals are not closed by this call. Returns the updated product detail (same shape as **Get Ad Health Product**).
List Guardrail Signals
Lists guardrail signals: problems the guardrail evaluation found with a product's advertising on one ad account (e.g. spending with low stock cover, ACoS above break-even). Each signal carries its type, severity, status, the product and account, a readable `reason`, the proposed `action`, whether it is `actionable` (and why not), any event freeze holding it (`frozen_by`), the raw evaluation `metrics`, the policy that raised it and the change set proposed for it.
Snooze Guardrail Signal
Snoozes an open (or already snoozed) signal until the end of the given day in the account's timezone. While snoozed the signal keeps being evaluated but takes no action and sends no alert; any open alert for it is resolved.
Dismiss Guardrail Signal
Dismisses an open or snoozed signal. The same problem for the same product and account is suppressed for 7 days (`dismissed_until`); any open alert for it is resolved. The reason is stored with the dismissing user's name appended.
Regenerate Guardrail Signal Change Set
Replaces a signal's pending change set that was planned under an older guardrail policy. The pending set is rejected (reason 'Regenerated under the current guardrail policy.'), the signal is unlinked from it, and a guardrail evaluation of the signal's ad account is queued so a new set is proposed under the current policy. Responds `202 Accepted`; the new set appears on the signal after the evaluation runs.
Propose Guardrail Signal Fix
Plans the signal's own fix now, as a change set waiting for approval, even when guardrails for its product are set to Monitor (which otherwise only flags problems). Use it for a signal whose decision card has `details.proposable: true`; once created, the set appears on the signal's decision with approve and reject actions.
List Guardrail Policies
Lists every guardrail policy: the tenant default first, then by scope type and ID. A policy sets the guardrail thresholds and automation `mode` (`off`, `monitor`, `suggest`, `auto`) for a scope: `tenant`, `platform` (scope_id is a platform value), `ad_account`, `campaign`, `brand` or `product` (scope_id is that record's ID). For a given product and account, the more specific policies override the less specific ones field by field. Each row includes `affected_products`, the number of evaluated products the policy's scope covers. Not paginated.
Create Guardrail Policy
Creates a guardrail policy for a scope. Only one policy may exist per scope. A new policy cannot start in `auto` mode: save it in `monitor` or `suggest`, run **Run Guardrail Policy Dry Run**, then switch it with **Update Guardrail Policy**. `mode` defaults to `monitor`. Returns `201` with the policy.
Resolve Guardrail Policy
Returns the effective guardrail policy for a context (any combination of product, ad account and campaign; none gives the tenant-level result), with the source of every field. `policy` is the fully merged policy; `sources` maps each setting path (e.g. `low_cover.pause_cover_days`, `mode`, `event_freezes`) to the policy that supplied it (`scope_type`, `policy_id`, `policy_name`; `scope_type: default` and null IDs for built-in defaults); `policy_ids` lists every contributing policy, least specific first; `most_specific_policy_id` is the last of them.
Get Guardrail Policy Impact
Returns, for each guardrail signal type that currently has open signals, the number of distinct products in it and their ad spend over the last 7 days (in the tenant currency). Use it to estimate how much spend a policy change would touch.
Update Guardrail Policy
Updates a guardrail policy's name, mode and settings. By default the settings you send are merged into the existing ones (deep merge); send `replace_settings: true` to replace them entirely. `event_freezes`, when sent, always replaces the list. A policy's scope cannot change (`scope_type` and `scope_id` are rejected). Tenant-scoped policies are always kept complete with the built-in defaults.
Delete Guardrail Policy
Deletes a guardrail policy. Its scope falls back to the less specific policies from the next evaluation on. The tenant default policy cannot be deleted (`422`).
Run Guardrail Policy Dry Run
Queues a dry run of the policy: a background replay of the last 7 days that works out which changes the policy would have proposed, without sending anything to an ad platform. Returns immediately with `tracked_job_log_id`, the ID of the background job, which reports progress and a summary (changes proposed, products processed, estimated spend saved, accounts processed, signals). When it finishes, the results are stored on the policy as `last_dry_run_at` / `last_dry_run_results`; a dry run in the last 7 days is required before the policy can be switched to `auto`.
Evaluate Ad Guardrails
Queues an immediate guardrail evaluation (normally run on a schedule) for the given ad accounts, or for every selected ad account when `ad_account_ids` is empty or omitted. The evaluation refreshes product health, raises and resolves signals and, for policies in `suggest` or `auto` mode, proposes change sets. Returns immediately with `tracked_job_log_id`, the ID of the background job that reports progress.