---
title: "run_campaign"
description: "Exécute une campaign et attend les résultats. Bloque jusqu'à la fin et renvoie les résultats par test."
sidebarTitle: "run_campaign"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

Exécute une campaign et attend les résultats — bloque jusqu'à la fin et renvoie les résultats par test.

<Warning>
  **Destructif · Écrit des données · Appelle des systèmes externes.** Cet outil peut modifier ou supprimer des données. Vérifiez les arguments avant de laisser un agent l'appeler.
</Warning>

## Paramètres

| Champ | Type | Requis | Description |
| --- | --- | --- | --- |
| `campaign_json` | string | Oui | Template JSON de la campaign (depuis build_campaign) |
| `ignore_errors` | boolean | Non | Ignore les échecs pour tous les types d'action (options.ignore_failed = &lt;all action codes&gt;). Les statuts par test peuvent être réécrits en success. |
| `max_poll_duration` | string | Non | Durée maximale d'attente des résultats (défaut : 10m). Format : chaîne de durée Go (ex. 5m, 15m) |
| `overrides` | string | Non | Objet JSON mappant les identifiants de test à leurs valeurs de variables et assignations d'owners. Format : \{"&lt;test_id&gt;": \{"input_variables": \{...\}, "direct_owners": \{...\}\}\}. direct_owners mappe l'identifiant de device à la valeur (ex. \{"sim_owner": "SIM-001"\}). Les valeurs d'input_variables sont des chaînes plates (ex. "42"). Pour cibler un variant spécifique, épinglez-le au moment du build via build_campaign variants=[…] — la forme objet \{value, bucket\} n'est PAS acceptée ici. |
| `parallel` | boolean | Non | Exécute les tests de la campaign en parallèle (options.parallel_test_execution=-1). Superadmin uniquement ; la plateforme rejette les listes de tests qui utilisent des actions SIM ou SMARTPHONE, ou sleep sur des ressources non verrouillées. |

## Exemple d'arguments

Arguments illustratifs qu'un agent fournit lors de l'appel de cet outil :

```json
{
  "campaign_json": "string"
}
```

## Description

```text
Best for quick ad-hoc / CI runs. It holds ONE connection open for the entire run, so on the hosted (HTTP) MCP transport a longer run can be reset by the gateway; for anything beyond a quick smoke test prefer start_execution + poll_execution (start returns a result_id immediately, then poll until terminal).

For ad-hoc runs: build_campaign(test_ids=…) → run_campaign. For a saved Tests campaign: build_campaign(test_campaign_id=…) → run_campaign(overrides=…).
```

## Associés

- [`start_execution`](/fr/mcp/tools/execution/start_execution)
- [`poll_execution`](/fr/mcp/tools/execution/poll_execution)
- [`build_campaign`](/fr/mcp/tools/execution/build_campaign)

## Et ensuite ?

<Columns cols={2}>
  <Card title="Tous les outils MCP" icon="robot" href="/fr/mcp/tools/overview">
    Parcourez la référence complète des outils par catégorie.
  </Card>
  <Card title="Connecter un client" icon="plug" href="/fr/mcp/connect">
    Configurez Claude, Cursor ou Claude Code avec le serveur.
  </Card>
</Columns>