TOOL API

optimizer_rule_update

Edits the settings of existing automated rules (apply objects, conditions, actions, notification, schedule, name). To only turn rules on/off or delete them, use `optimizer_rule_update_status_update` instead; this tool has no status field. Recommended flow: read the current rule with `optimizer_rule_get`, change only what the user asked for, and send the complete rule back in `rules`. `advertiser_id`, `dimension_ids`, and `rule_id` are strings.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.optimizer_rule_update
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

advertiser_idrequired

Advertiser ID. Updating rules requires edit access to this advertiser in Business Center; view-only access is not enough. If the response says `Insufficient permission`, do not retry or change other parameters; tell the user to ask their BC admin to grant edit access to this advertiser.

lang

Language for error messages. Defaults to `EN` if omitted.

rulesrequired

Required. A JSON array of rule objects (not a JSON-encoded string), e.g. [{"rule_id": "...", "name": "...", ...}]. Each item must include all of: `rule_id`, `name`, `apply_objects`, `conditions`, `actions`, `notification`, `rule_exec_info`. There is no `status` or `rule_name` field.