Campaigns - Darwin

Every campaign pins an owned agent, operation ID, and operation revision. It stores its billing event, USD budget in cents, targeting, schedule, and current lifecycle revision.

Commands

Use Advertise for all mutations. create returns DRAFT; update changes selected draft or paused terms; submit records PENDING_REVIEW; pause records PAUSED. Each mutation requires an Idempotency-Key; all changes after creation require expectedRevision.

Reporting

Get campaign reads persisted configuration and status. The budget ceiling is not spend. delivery.status remains NOT_ACTIVE in this management implementation; impressions, conversations, conversions, and spend are null, not simulated campaign results.

Activation boundary

There is no command here that silently starts serving or moves money. Paid delivery needs independent eligibility, Sponsored disclosure, funding authorization, event attribution, budget enforcement, and settlement. Submitting the campaign does not skip those requirements.

Last modified on October 19, 2026