Plan Before Mutate — Dry-run & Confirmation Token
Workflow de prévisualisation avant write GAM : plan lisible, coût crédits, risques irréversibles, validité temporelle et token de confirmation.
Endpoints REST
| Méthode | Path | Description | Crédits |
|---|---|---|---|
| POST | /api/campaigns/{id}/dry-run | Prévisualiser un deploy campaign sans write GAM | 0 |
| POST | /api/jobs/{id}/deploy | Exécuter un deploy confirmé | 5 |
| POST | /api/jobs/{id}/deployment-plan | Construire le plan d'un staging draft | 0 |
| POST | /api/inventory/blueprints/{id}/push | Push blueprint avec diff et token | 0 / 0.5 unit |
Outils MCP
| Outil | Description | Crédits |
|---|---|---|
| campaign(action='create_draft') | Créer un staging draft avant mutation GAM | 0 |
| campaign(action='deploy', dryRun=true) | Retourner l'ExecutionPlan et le confirmation token | 0 |
| campaign(action='deploy', confirmationToken=...) | Consommer le token et exécuter | 5 |
| campaign(action='create_display', dryRun=true) | Forecast display + plan avant création | 0 |
| push_inventory_blueprint(dryRun=true) | Diff blueprint complet avant push | 0 |
| push_inventory_blueprint(confirmationToken=...) | Push blueprint confirmé vers GAM | 0.5/unit |
Exemples
Campaign deploy en deux étapes
{
"tool": "campaign",
"arguments": { "action": "deploy", "jobId": "job_8b2a", "dryRun": true }
}
// -> ExecutionPlan { mutations, estimatedCost, irreversible, planValidUntil, confirmationToken }
{
"tool": "campaign",
"arguments": { "action": "deploy", "jobId": "job_8b2a", "confirmationToken": "tok_9c3f", "dryRun": false }
}Notes
- • Le token est lié au tenant, au type d'opération et au hash canonique du plan.
- • dryRun=true ne produit aucun write GAM.
- • Les risques irréversibles sont affichés avant confirmation.
- • Un plan expiré doit être regénéré avant exécution.