archive_ad
Archive (soft-delete) one or more ads on the Metadata platform.
Destructive creative
Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.
What it does
Archive (soft-delete) one or more ads on the Metadata platform.
ARCHIVE IS HOW YOU DELETE AN AD. The platform has NO hard-delete
endpoint for ads — archive is the soft-delete and the only way to
remove an ad from the active library. When the user says
"delete this ad", "remove this ad", "discard this ad", "trash this
ad", or "get rid of this ad" → call archive_ad. Do NOT hallucinate
a delete_ad or remove_ad tool; it does not exist.
The archived ad is preserved on the platform (it still has its id,
creative_json, and history) and can be restored with unarchive_ad.
USE THIS TOOL WHEN:
- User asks to delete, remove, discard, trash, drop, retire, or
archive one or more ads.
- User wants to clean up draft ads they no longer need.
- User asks "make this ad go away" or similar.
HOW TO GET THE id(s):
- search_ads_by_names(ad_names=[...]) → returns active ad ids.
- get_ad_details(ids=...) → confirms an ad exists if the id is
already known (works for active ads).
ALSO KNOWN AS: archive ad, delete ad, remove ad, discard ad,
trash ad, drop ad, retire ad, soft-delete ad, get rid of ad.
KEYWORDS: archive, delete, remove, discard, trash, drop, retire,
soft-delete, hide, get rid of, clean up, ad cleanup.
PARAMETERS:
- ids: Array of integer ad ids (at least one). Bulk-friendly —
pass several ids to archive multiple ads in a single call.
RETURNS:
{ "success": true, "archived_ids": [123, 456], "count": 2 }
To bring an archived ad back, call unarchive_ad with the same id(s).Arguments
| Argument | Type | Notes | |
|---|---|---|---|
ids |
array | required | Ad id(s) to archive. At least one integer required; pass multiple to archive in bulk. |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"archive_ad","arguments":{"ids":[]}}}'Response
No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs.
The request above is still the exact shape to send. Nothing on this page is invented.
Related
Other creative tools: