> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Campaigns

> Manage a durable campaign with explicit revisions and delivery state.

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](/docs/reference/studio-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](/docs/reference/studio-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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.