---
title: "manage_experiment. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/manage_experiment
description: "Pause or restart a whole experiment (a launched channel campaign inside a wizard campaign). Destructive tool on the Metadata MCP server, with its full JSON Schema."
source: metadata.io
---

# manage_experiment

Pause or restart a whole experiment (a launched channel campaign inside a wizard campaign).

Destructive [campaigns](https://metadata.io/developers/tools/#cat-campaigns)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `experiment_id` | integer | required | The experiment ID to pause or restart (experimentId from search_experiments). |
| `action` | string | required | The action to perform: 'pause' to stop the experiment, 'restart' to resume itone of: `pause`, `restart` |
| `confirm_budget_impact` | boolean |   | Restart only. Set true ONLY after the user explicitly confirmed the budget-group impact returned by a previous manage_experiment call with status='requires_confirmation'. |
| `auto_pause_ignore_historical_data` | boolean |   | Restart only. When the experiment was auto-paused for low performance, true tells the optimizer to ignore the historical performance data that caused the pause. |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## Response

## Related

Other campaigns tools:

- [add_and_edit_campaign_elements](https://metadata.io/developers/tools/add_and_edit_campaign_elements) Destructive
- [add_and_edit_native_campaign_elements](https://metadata.io/developers/tools/add_and_edit_native_campaign_elements) Destructive
- [check_campaign_launch_readiness](https://metadata.io/developers/tools/check_campaign_launch_readiness) Read
- [connect_channel](https://metadata.io/developers/tools/connect_channel) Writes
- [create_budget_group](https://metadata.io/developers/tools/create_budget_group) Writes
- [create_campaign](https://metadata.io/developers/tools/create_campaign) Writes
- [create_native_structure_campaign](https://metadata.io/developers/tools/create_native_structure_campaign) Writes
- [create_update_offer](https://metadata.io/developers/tools/create_update_offer) Destructive

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)