unarchive_ad

Unarchive (restore) one or more previously archived ads.

                    Brings an archived (soft-deleted) ad back to active status. The
                    reverse of archive_ad. The ad's id, creative_json, and history are
                    preserved across archive/unarchive — same row, status flip.

                    USE THIS TOOL WHEN:
                    - User asks to restore, unarchive, undelete, recover, reactivate,
                      bring back, or undo the archiving of an ad.
                    - User wants to reuse an ad they previously archived.

                    HOW TO GET THE id(s) FOR ARCHIVED ADS:
                    - Archived ads are NOT returned by `search_ads_by_names` by default
                      (the default `status="active"` filters them out).
                    - Call `search_ads_by_names(ad_names=[...], status="archived")` to
                      get ONLY archived ads in the results, then pass the matching ids
                      to this tool. Use `status="all"` if you also want active matches
                      in the same response (rare; usually you want just "archived").
                    - get_ad_details(ids=...) works on archived ids too if you already
                      have the id.

                    ALSO KNOWN AS: unarchive ad, restore ad, undelete ad, recover ad,
                    reactivate ad, bring back ad, undo archive.

                    KEYWORDS: unarchive, restore, undelete, recover, reactivate,
                    bring back, undo archive, revive, resurrect.

                    PARAMETERS:
                    - ids: Array of integer ad ids (at least one). Bulk-friendly.

                    RETURNS:
                    { "success": true, "unarchived_ids": [123, 456], "count": 2 }