account | DynamicAccount | Yes | - | Select the X Ads account that owns the ads. |
update_type | string or SelectableOption | Yes | - | Choose whether to update a single ad or multiple at once. Options: single or bulk. |
ad_id | string or SelectItem | No | - | X Ads ad (promoted tweet) ID to update. Required for single update. |
status | string or SelectableOption | No | - | New ad status. X only supports DELETED for ads: the post is detached from its ad group permanently (shown as Paused in the X UI) and this cannot be undone. To resume, promote the same post again with x_ads_create_ad. Required for single update. |
structured_data | array (also accepts a comma-separated string) | No | - | Use only when update_type is bulk. Required columns: ad_id and status (only DELETED is supported; it permanently detaches the post). Up to 100 rows. |