@adcp/client API Reference - v4.18.2
    Preparing search index...

    Interface SyncCreativesRequest

    Request parameters for syncing creative assets with upsert semantics - supports bulk operations, scoped updates, and assignment management

    interface SyncCreativesRequest {
        account: AccountReference;
        creatives: CreativeAsset[];
        creative_ids?: string[];
        assignments?: {
            creative_id: string;
            package_id: string;
            weight?: number;
            placement_ids?: string[];
        }[];
        idempotency_key?: string;
        delete_missing?: boolean;
        dry_run?: boolean;
        validation_mode?: ValidationMode;
        push_notification_config?: PushNotificationConfig;
        context?: ContextObject;
        ext?: ExtensionObject;
    }
    Index

    Properties

    account creatives creative_ids? assignments? idempotency_key? delete_missing? dry_run? validation_mode? push_notification_config? context? ext?

    Properties

    account: AccountReference
    creatives: CreativeAsset[]

    Array of creative assets to sync (create or update)

    creative_ids?: string[]

    Optional filter to limit sync scope to specific creative IDs. When provided, only these creatives will be created/updated. Other creatives in the library are unaffected. Useful for partial updates and error recovery.

    assignments?: {
        creative_id: string;
        package_id: string;
        weight?: number;
        placement_ids?: string[];
    }[]

    Optional bulk assignment of creatives to packages. Each entry maps one creative to one package with optional weight and placement targeting. Standalone creative agents that do not manage media buys ignore this field.

    Type Declaration

    • creative_id: string

      ID of the creative to assign

    • package_id: string

      ID of the package to assign the creative to

    • Optionalweight?: number

      Relative delivery weight (0-100). When multiple creatives are assigned to the same package, weights determine impression distribution proportionally. When omitted, the creative receives equal rotation with other unweighted creatives. A weight of 0 means the creative is assigned but paused (receives no delivery).

    • Optionalplacement_ids?: string[]

      Restrict this creative to specific placements within the package. When omitted, the creative is eligible for all placements.

    idempotency_key?: string

    Client-generated idempotency key for safe retries. If a sync fails without a response, resending with the same idempotency_key guarantees at-most-once execution. MUST be unique per (seller, request) pair to prevent cross-seller correlation. Use a fresh UUID v4 for each request.

    delete_missing?: boolean

    When true, creatives not included in this sync will be archived. Use with caution for full library replacement. Invalid when creative_ids is provided — delete_missing applies to the entire library scope, not a filtered subset.

    dry_run?: boolean

    When true, preview changes without applying them. Returns what would be created/updated/deleted.

    validation_mode?: ValidationMode
    push_notification_config?: PushNotificationConfig
    context?: ContextObject
    ext?: ExtensionObject

    Settings

    Member Visibility

    On This Page

    Properties