@adcp/sdk API Reference - v10.0.1
    Preparing search index...

    Interface UpdateMediaBuySuccess

    Success response - media buy updated successfully

    interface UpdateMediaBuySuccess {
        media_buy_id: string;
        media_buy_status?: MediaBuyStatus;
        status?: MediaBuyStatus;
        revision?: number;
        currency?: string;
        total_budget?: number;
        implementation_date?: string | null;
        invoice_recipient?: BusinessEntity;
        affected_packages?: Package[];
        valid_actions?: MediaBuyValidAction[];
        available_actions?: MediaBuyAvailableAction[];
        sandbox?: boolean;
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    media_buy_id: string

    Seller's identifier for the media buy

    media_buy_status?: MediaBuyStatus
    status?: MediaBuyStatus
    revision?: number

    Revision number after this update. Use this value in subsequent update_media_buy requests intended to change state for optimistic concurrency. Exact idempotency replays return the prior revision and do not increment revision.

    1

    currency?: string

    ISO 4217 currency code for monetary values at this media buy level. Echoed when the update affects budget or currency. Matches the currency field in subsequent get_media_buys responses.

    ^[A-Z]{3}$

    total_budget?: number

    Updated total budget amount across all packages, denominated in currency. Echoed when the update affects package budgets so buyers can verify the new aggregate without a round-trip to get_media_buys. Matches the total_budget field in subsequent get_media_buys responses.

    0

    implementation_date?: string | null

    ISO 8601 timestamp when changes take effect (null if pending approval)

    date-time

    invoice_recipient?: BusinessEntity
    affected_packages?: Package[]

    For package-level updates, array of full Package objects showing complete post-update state for each directly modified package. This is a state snapshot, not a sparse delta: sellers MUST NOT return package_id-only stubs. Campaign-level updates that do not modify packages may return an empty array.

    valid_actions?: MediaBuyValidAction[]

    Flat-vocabulary actions the buyer can perform after this update. Saves a round-trip to get_media_buys. Deprecated in favor of available_actions[], which carries mode, optional SLA, and optional terms_ref. Sellers SHOULD populate both during the 3.x deprecation window; consumers MUST prefer available_actions[] when both are present. Removed in 4.0.

    available_actions?: MediaBuyAvailableAction[]

    Structured per-buy resolution of actions available after this update. Authoritative — see get-media-buys-response.json for full semantics.

    sandbox?: boolean

    When true, this response contains simulated data from sandbox mode.

    context?: ContextObject
    ext?: ExtensionObject