Rules
List Rules
Lists automation rules, newest first (ordered by ID descending).
Create Rule
Creates an automation rule. Rules propose changes on their cron schedule; in `suggest` mode every run produces change sets that must be approved before anything reaches the ad platform.
Get Rule
Returns one automation rule.
Update Rule
Replaces an automation rule's definition. The same body and validation as Create Rule apply; send the full rule (omitted optional objects are cleared). The original creator is kept.
Delete Rule
Deletes an automation rule. It stops running on its schedule; returns 204 with no body.
Run Rule
Runs a rule now, outside its schedule. The run is queued and tracked: the response returns a `tracked_job_log_id` to poll for progress. When it finishes, read the result with List Rule Runs / Get Rule Run.
Backtest Rule
Queues a backtest: replays the rule over the last `days` days and records what it would have changed as a projection run (`is_projection: true`, `summary.lines` holds up to the projected changes). Nothing is submitted or changed. Poll the returned `tracked_job_log_id`, then read the run.
List Rule Runs
Lists a rule's runs (scheduled, manual, dry runs and backtests), newest first.
Get Rule Dayparting Schedule
Returns the dayparting schedules learned by the rule's latest completed real run, keyed by campaign ID. Each schedule holds a bid multiplier per ISO weekday (1 = Monday ... 7 = Sunday) and hour (0-23, in the account time zone), smoothed and clamped to the rule's multiplier range (0.5-1.5 by default), plus the per-hour multipliers across the week.
Get Rule Run
Returns one rule run: counts evaluated/proposed/skipped, the change sets produced, and the summary (notes; for a backtest, the projection label, `backtest_days` and the projected change lines; for a failed run, `summary.error`).