Update Rule
PUT/api/advertising/rules/: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.
advertising:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Requires the advertising.manage permission and the Advertising Manager feature.
Body fields:
name(required, string, max 255)rule_type(required):bid_to_target_poas,budget_pacing,harvest_search_terms,negate_search_terms,dayparting,placement_adjustorcustom.platform(optional):amazon_ads,ebay,google_ads,walmart_connect,meta_ads,tiktok_ads. Null runs on every platform.daypartingandplacement_adjustneed Amazon Marketing Stream data and accept onlyamazon_ads(or null).mode(optional, defaultsuggest):suggest(proposals become change sets awaiting approval) orauto(applied automatically). Settingautoadditionally requires theadvertising.approvepermission (403 otherwise).status(optional, defaultactive):activeorpaused.schedule(optional, cron expression, max 100 chars). Defaults to15 * * * *forbudget_pacingand0 6 * * *for every other type. An invalid cron returns 422 onschedule.scope(optional object, only these keys):ad_account_ids[](existing ad account IDs),campaign_ids[](existing campaign IDs),campaign_name_pattern(string),campaign_types[](campaign type values such asamazon_sp,ebay_general,google_pmax),product_ids[](existing product IDs). An empty scope covers every selected ad account of the rule's platform.conditions(optional object; which keys apply depends onrule_type):lookback_days1-90,min_clicks1-10000,min_orders1-1000target_poas1.0-20 (POAS below 1.0 is below break-even and is rejected),target_margin_pts0-100max_bid_change_pct1-100,budget_step_pct1-100,budget_cutoff_day_pct10-100,underspend_pct1-100,max_budget> 0,k1-20- harvest / negate:
match_type(exact|phrase),level(campaign|ad_group),bid_multiplier0.5-3,negate_in_source(boolean),destination_ad_group_id(existing ad group ID) daypartingobject:min_days28-120,min_multiplier0.5-1,max_multiplier1-1.5,cell_prior_clicks,hour_prior_clicks- custom rules:
entity(target|item|ad_group|campaign),match(all|any),clauses[](max 20) each withmetric,opand numeric/booleanvalue. Metrics:impressions,clicks,spend,sales,orders,units,ctr,cpc,cvr,acos,roas,poas,bid,budget, plus SKU.io inventory inputscover_days,available,inbound_within_lead_time,days_to_next_inbound,forecast_daily,break_even_acos,unit_contribution,aged_days,buy_box_owned,poas_7d,poas_30d. Operators:>,>=,<,<,=,!=.
actions(optional object, custom rules):type(set_bid_pct,set_bid,set_budget_pct,set_budget,pause,enable) andvalue(numeric; required for the set_* actions).caps_override(optional object):max_bid_change_pct1-100 andmax_budget> 0, overriding the account guardrail caps for this rule.
A custom rule must have at least one clause and an action.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden
Response Headers
Not Found
Response Headers
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.