MMetadata /docs
Docs/Tools/restart_experiment_keyword

restart_experiment_keyword

Restart a specific paused keyword in an experiment.

Writes search

Creates or changes something in the account. Put it behind whatever review your agent uses.

What it does

Restart a specific paused keyword in an experiment.

                PURPOSE:
                Restart a keyword that was previously paused in an experiment. This re-enables the keyword
                so it starts running again in the specified experiment.

                SCOPE - THIS TOOL ACTS ON ONE KEYWORD, NOT ON THE EXPERIMENT:
                It restarts a SINGLE keyword INSIDE an experiment. It cannot restart a paused
                experiment. To pause or restart a WHOLE experiment, use manage_experiment instead.

                WHEN TO USE:
                - Restart a keyword that was previously paused in an experiment
                - Re-enable a keyword after resolving performance issues
                - Resume keyword activity in a specific experiment

                PREREQUISITE:
                Use list_experiment_keywords first to find the keywordExternalId and wizExperimentId
                for the keyword you want to restart. Both come from that tool's results:
                keywordExternalId identifies the keyword on the ad channel, and wizExperimentId
                is the experiment's ID (the same ID search_experiments returns as experimentId).

                WORKFLOW:
                1. Search for the keyword: list_experiment_keywords(keywordOrExperimentName="my keyword")
                2. Note the keywordExternalId and wizExperimentId from the results
                3. Restart it: restart_experiment_keyword(keywordExternalId=12345, wizExperimentId=678)
                4. (Optional) Verify later: list_experiment_keywords(keywordOrExperimentName="my keyword")
                   to check the status has changed

                PARAMETERS:
                - keywordExternalId: Required. The external ID of the keyword to restart (from list_experiment_keywords).
                - wizExperimentId: Required. The experiment ID where the keyword is running (from list_experiment_keywords).

                ⚠️ WARNING: This action changes the state of the keyword in the experiment.
                The keyword will resume running in the specified experiment.

                ⚠️ ASYNC FLOW: Restarting a keyword is an asynchronous operation. The status change
                may not be immediately reflected. Use list_experiment_keywords after some time
                to verify the keyword status has been updated.

Arguments

ArgumentTypeNotes
keywordExternalId integer required The external ID of the keyword to restart.
wizExperimentId integer required The experiment ID where the keyword is running.

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":"restart_experiment_keyword","arguments":{"keywordExternalId":0,"wizExperimentId":0}}}'

Response

No recorded response. This tool writes to the account, 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 search tools:

All 160 tools · machine-readable index