MMetadata /docs
⌘K
Docs/Tools/archive_audience

archive_audience

Archive (delete) a custom audience from the Metadata platform.

Destructive audiences

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Archive (delete) a custom audience from the Metadata platform.
                        Use this tool when the user wants to archiveo or delete a custom audience from the entire System.

                        You can identify the audience either by its numeric custom_audience_id or by its name.
                        If only the audience name is provided, the tool will search existing audiences to resolve the correct ID before archiving.

                        PARAMETERS:
                        • custom_audience_id (optional): The numeric ID of the custom audience to archive.
                        • audience_name (optional): The name of the custom audience to archive. Used to look up the ID if custom_audience_id is not provided.

                        At least one of custom_audience_id or audience_name must be provided.

                        RESPONSE:
                        • actionStatus: "SUCCEEDED" if the audience was archived successfully.

Arguments

ArgumentTypeNotes
custom_audience_id integer The numeric ID of the custom audience to archive.
audience_name string The name of the custom audience to archive. If provided without custom_audience_id, the tool will search for the audience by name to resolve the ID.

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_audience","arguments":{}}}'

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.

Other audiences tools:

All 160 tools · machine-readable index