Plan Before Mutate

Plan.
Then execute.

Every GAM mutation first goes through a readable plan: planned mutations, credit cost, irreversible risks, time validity and confirmation token.

Try the dry-run Plan Before Mutate documentation →

surprise writes

5 min

plan validity

100%

predictable mutations

Token

anti-replay

Features

What you can do

Readable execution plan

Before each GAM write, receive the list of planned mutations, the identified irreversible risks and the exact cost in credits.

Time validity

The plan is signed and valid for a few minutes. After that, it must be regenerated to reflect the current state.

Anti-replay confirmation token

The confirmation token ties the operation to the tenant, the action type and the canonical hash of the plan. It can only be consumed once.

Irreversible risks flagged

Sensitive mutations in GAM, such as Order creation or ad unit archiving, are flagged before confirmation.

Dry-run without side effects

campaign(dryRun=true) and push_inventory_blueprint(dryRun=true) write nothing to GAM. The forecast and the diff stay read-only.

Automatic audit trail

Every preview and every confirmed execution can be reviewed in the tenant's audit trail.

Real execution

See it in action

plan-before-mutate.log

$ campaign(action='create_display', dryRun=true)

→ Forecast: 62,340 impressions available (FR)

ExecutionPlan:

mutations: 1 Order + 3 LineItems + 3 LICAs

estimatedCost: 5 credits | balance: 42 credits

irreversible: Order creation cannot be undone

planValidUntil: 5 min — confirmationToken: tok_9c3f

$ campaign(action='create_display', confirmationToken='tok_9c3f')

✓ Campaign deployed — Order #789012 | 3 LIs | preview URLs ready