Skip to main content

Prerelease upgrade notes (rc.1 → rc.2)

If you adopted 3.0.0-rc.1, review these changes before upgrading to rc.2. If you are migrating from v2, see the main migration guide.

Potentially breaking for rc.1 adopters

Arearc.1rc.2What to do
Account auth modelaccount_resolution capabilityRemoved — require_operator_auth now determines account modelUpdate capability parsing and auth/account branching logic
Creative library task boundarylist_creatives / sync_creatives documented under Media BuyCreative library operations live in the Creative ProtocolRoute library reads/writes through Creative Protocol assumptions, even when a sales agent implements both protocols
Sandbox capability discoverymedia_buy.features.sandboxaccount.sandboxRead sandbox support from the account capability block
DOOH flat rate parametersflat_rate.parameters without discriminatorflat_rate.parameters.type: "dooh" required when parameters are presentAdd the discriminator in request builders and validators
Deprecated governance task docsdelete_content_standards, get_property_features documentedRemovedUse update_content_standards, property lists, and get_adcp_capabilities instead

Additive changes in rc.2

  • Creative generation and previewbuild_creative adds include_preview, preview_inputs, preview_quality, preview_output_format, quality, item_limit, and multi-format target_format_ids. Buyers can now preview inline, choose draft vs production generation, and request multiple output formats in one call.
  • Creative library retrievalbuild_creative also supports library retrieval using creative_id, optional concept_id, media_buy_id, package_id, and macro_values, so ad servers and creative platforms can resolve stored creatives into delivery-ready manifests.
  • Creative capability discovery — Creative agents can declare supports_generation, supports_transformation, and has_creative_library. list_creatives now uses library-oriented fields like include_snapshot, has_served, and items.
  • Product discovery and planningget_products adds exclusivity, preferred_delivery_types, and time_budget, with incomplete in the response. Products may omit delivery_measurement, and packages can now carry per-package start_time / end_time.
  • Compliance and governance — Creative disclosures add persistence semantics, and campaign governance introduces sync_plans, check_governance, report_plan_outcome, and get_plan_audit_logs.
  • Accounts and sandbox ergonomicssync_accounts adds payment_terms, and sandbox now participates in the natural account key for implicit account references.