taboola-backstage-sdk 0.2.1 → 0.6.0

package/dist/index.d.ts

@@ -149,23 +149,25 @@ type ItemStatus = 'RUNNING' | 'CRAWLING' | 'CRAWLING_ERROR' | 'NEED_TO_EDIT' | '
 /**
  * Pricing models
  */
-type PricingModel = 'CPC' | 'CPM' | 'VCPM' | 'CPV' | 'CPA';
+type PricingModel = 'CPC' | 'CPM' | 'VCPM';
 /**
  * Spending limit models
  */
 type SpendingLimitModel = 'MONTHLY' | 'ENTIRE' | 'DAILY' | 'NONE';
 /**
  * Daily ad delivery models
+ *
+ * @remarks ACCELERATED is deprecated by Taboola
  */
 type DailyAdDeliveryModel = 'ACCELERATED' | 'BALANCED' | 'STRICT';
 /**
  * Marketing objectives
  */
-type MarketingObjective = 'DRIVE_WEBSITE_TRAFFIC' | 'BRAND_AWARENESS' | 'DRIVE_PURCHASES' | 'GENERATE_LEADS' | 'DRIVE_APP_INSTALLS' | 'MAX_CONVERSIONS';
+type MarketingObjective = 'DRIVE_WEBSITE_TRAFFIC' | 'BRAND_AWARENESS' | 'ONLINE_PURCHASES' | 'LEADS_GENERATION' | 'MOBILE_APP_INSTALL' | 'OTHER';
 /**
  * Bid strategies
  */
-type BidStrategy = 'FIXED' | 'SMART' | 'TARGET_CPA' | 'MAX_CONVERSIONS' | 'TARGET_ROAS';
+type BidStrategy = 'FIXED' | 'SMART' | 'TARGET_CPA' | 'MAX_CONVERSIONS';
 /**
  * Traffic allocation modes
  */
@@ -197,13 +199,13 @@ type BrandSafetyProvider = 'IAS' | 'DV' | 'MOAT' | 'NONE';
 /**
  * Report dimension types
  */
-type ReportDimension = 'day' | 'by_hour_of_day' | 'week' | 'month' | 'content_provider_breakdown' | 'campaign_breakdown' | 'site_breakdown' | 'country_breakdown' | 'region_breakdown' | 'dma_breakdown' | 'platform_breakdown' | 'campaign_day_breakdown' | 'campaign_site_day_breakdown' | 'user_segment_breakdown' | 'campaign_week' | 'campaign_month' | 'site_day' | 'country_day' | 'platform_day' | 'browser' | 'browser_day' | 'os_family' | 'os_family_day' | 'item_breakdown' | 'campaign' | 'site' | 'country' | 'platform';
+type ReportDimension = 'day' | 'by_hour_of_day' | 'week' | 'month' | 'content_provider_breakdown' | 'campaign_breakdown' | 'campaign_hour_breakdown' | 'site_breakdown' | 'country_breakdown' | 'content_provider_country_breakdown' | 'region_breakdown' | 'dma_breakdown' | 'platform_breakdown' | 'campaign_day_breakdown' | 'campaign_site_day_breakdown' | 'user_segment_breakdown' | 'os_family_breakdown' | 'os_version_breakdown' | 'browser_breakdown' | 'contextual_breakdown';
 /**
  * Realtime Campaign Report dimension types
  *
  * @see https://developers.taboola.com/backstage-api/reference/realtime-campaign-report
  */
-type RealtimeCampaignDimension = 'by_hour' | 'by_campaign' | 'by_site' | 'by_country' | 'by_platform' | 'by_campaign_by_hour' | 'by_campaign_by_site' | 'by_campaign_by_country' | 'by_campaign_by_platform' | 'by_campaign_by_country_by_platform' | 'by_platform_by_country';
+type RealtimeCampaignDimension = 'by_hour' | 'by_campaign' | 'by_site' | 'by_country' | 'by_platform' | 'by_campaign_by_hour' | 'by_campaign_by_site' | 'by_campaign_by_country' | 'by_campaign_by_platform' | 'by_campaign_by_country_by_platform' | 'by_platform_by_country' | 'by_hour_by_smallest_time_bucket' | 'by_campaign_by_smallest_time_bucket' | 'by_site_by_smallest_time_bucket' | 'by_country_by_smallest_time_bucket' | 'by_platform_by_smallest_time_bucket';
 /**
  * Realtime Ads Report dimension types
  *
@@ -286,6 +288,8 @@ interface Account {
     campaign_types: CampaignType[];
     /** Account currency */
     currency: CurrencyCode;
+    /** Account time zone name */
+    time_zone_name?: string;
 }
 /**
  * Advertiser account in network
@@ -305,19 +309,17 @@ interface AdvertiserAccount {
     campaign_types: CampaignType[];
     /** Account currency */
     currency: CurrencyCode;
+    /** Account time zone name */
+    time_zone_name?: string;
 }
 /**
  * Response for allowed accounts list
  */
-interface AllowedAccountsResponse {
-    results: Account[];
-}
+type AllowedAccountsResponse = ListResponse<Account>;
 /**
  * Response for network advertisers list
  */
-interface NetworkAdvertisersResponse {
-    results: AdvertiserAccount[];
-}
+type NetworkAdvertisersResponse = ListResponse<AdvertiserAccount>;
 
 /**
  * Campaign types for Taboola Backstage API
@@ -534,14 +536,16 @@ interface CreateCampaignRequest {
     name: string;
     /** Branding text (required) */
     branding_text: string;
+    /** Marketing objective (required) */
+    marketing_objective: MarketingObjective;
+    /** Pricing model */
+    pricing_model?: PricingModel;
     /** Cost per click */
     cpc?: number;
     /** Spending limit */
     spending_limit?: number;
     /** Spending limit model */
     spending_limit_model?: SpendingLimitModel;
-    /** Marketing objective (required) */
-    marketing_objective: MarketingObjective;
     /** Daily cap */
     daily_cap?: number;
     /** Daily ad delivery model */
@@ -552,29 +556,80 @@ interface CreateCampaignRequest {
     cpa_goal?: number;
     /** Country targeting */
     country_targeting?: TargetingValue;
+    /** Sub-country (region) targeting */
+    sub_country_targeting?: TargetingValue;
+    /** DMA targeting (US only) */
+    dma_country_targeting?: TargetingValue;
+    /** Region targeting */
+    region_country_targeting?: TargetingValue;
+    /** City targeting */
+    city_targeting?: TargetingValue;
+    /** Postal code targeting */
+    postal_code_targeting?: TargetingValue;
+    /** Contextual targeting */
+    contextual_targeting?: TargetingValue;
     /** Platform targeting */
     platform_targeting?: TargetingValue;
+    /** Publisher targeting (blocking) */
+    publisher_targeting?: TargetingValue;
     /** OS targeting */
     os_targeting?: TargetingValue;
-    /** Start date */
+    /** Connection type targeting */
+    connection_type_targeting?: TargetingValue;
+    /** Browser targeting */
+    browser_targeting?: TargetingValue;
+    /** Auto publisher targeting */
+    auto_publisher_targeting?: TargetingValue;
+    /** Publisher bid modifiers */
+    publisher_bid_modifier?: PublisherBidModifierCollection;
+    /** Publisher bid strategy modifiers */
+    publisher_bid_strategy_modifiers?: PublisherBidStrategyModifierCollection;
+    /** Start date (defaults to 'now' if omitted) */
     start_date?: DateString;
     /** End date */
     end_date?: DateString;
+    /** Whether campaign is active */
+    is_active?: boolean;
     /** Tracking code */
     tracking_code?: string;
     /** Comments */
     comments?: string;
     /** Traffic allocation mode */
     traffic_allocation_mode?: TrafficAllocationMode;
+    /** A/B test end date */
+    traffic_allocation_ab_test_end_date?: DateString | null;
+    /** External brand safety config */
+    external_brand_safety?: ExternalBrandSafety;
+    /** Marketplace audience targeting */
+    audience_segments_multi_targeting?: MultiTargeting;
+    /** Custom audience targeting */
+    custom_audience_targeting?: MultiTargeting;
+    /** Marking label targeting */
+    marking_label_multi_targeting?: MultiTargeting;
+    /** Lookalike audience targeting */
+    lookalike_audience_targeting?: MultiTargeting;
+    /** Contextual segments targeting */
+    contextual_segments_targeting?: MultiTargeting;
+    /** Verification pixel config */
+    verification_pixel?: VerificationPixel;
+    /** Viewability tag config */
+    viewability_tag?: ViewabilityTag;
+    /** Activity schedule */
+    activity_schedule?: ActivitySchedule;
 }
 /**
  * Campaign update request
+ *
+ * Submit a JSON object with only the fields you want to update.
+ * Fields that are omitted or null will not be updated.
  */
 interface UpdateCampaignRequest {
     /** Campaign name */
     name?: string;
     /** Branding text */
     branding_text?: string;
+    /** Pricing model */
+    pricing_model?: PricingModel;
     /** Cost per click */
     cpc?: number;
     /** Spending limit */
@@ -591,20 +646,68 @@ interface UpdateCampaignRequest {
     cpa_goal?: number;
     /** Country targeting */
     country_targeting?: TargetingValue;
+    /** Sub-country (region) targeting */
+    sub_country_targeting?: TargetingValue;
+    /** DMA targeting (US only) */
+    dma_country_targeting?: TargetingValue;
+    /** Region targeting */
+    region_country_targeting?: TargetingValue;
+    /** City targeting */
+    city_targeting?: TargetingValue;
+    /** Postal code targeting */
+    postal_code_targeting?: TargetingValue;
+    /** Contextual targeting */
+    contextual_targeting?: TargetingValue;
     /** Platform targeting */
     platform_targeting?: TargetingValue;
+    /** Publisher targeting (blocking) */
+    publisher_targeting?: TargetingValue;
     /** OS targeting */
     os_targeting?: TargetingValue;
+    /** Connection type targeting */
+    connection_type_targeting?: TargetingValue;
+    /** Browser targeting */
+    browser_targeting?: TargetingValue;
+    /** Auto publisher targeting */
+    auto_publisher_targeting?: TargetingValue;
+    /** Publisher bid modifiers */
+    publisher_bid_modifier?: PublisherBidModifierCollection;
+    /** Publisher bid strategy modifiers */
+    publisher_bid_strategy_modifiers?: PublisherBidStrategyModifierCollection;
+    /** Campaign profile ID */
+    campaign_profile?: string | null;
     /** Start date */
-    start_date?: DateString;
+    start_date?: DateString | null;
     /** End date */
-    end_date?: DateString;
-    /** Whether campaign is active */
+    end_date?: DateString | null;
+    /** Whether campaign is active (use for pause/unpause) */
     is_active?: boolean;
     /** Tracking code */
     tracking_code?: string;
     /** Comments */
     comments?: string;
+    /** Traffic allocation mode */
+    traffic_allocation_mode?: TrafficAllocationMode;
+    /** A/B test end date */
+    traffic_allocation_ab_test_end_date?: DateString | null;
+    /** External brand safety config */
+    external_brand_safety?: ExternalBrandSafety;
+    /** Marketplace audience targeting */
+    audience_segments_multi_targeting?: MultiTargeting;
+    /** Custom audience targeting */
+    custom_audience_targeting?: MultiTargeting;
+    /** Marking label targeting */
+    marking_label_multi_targeting?: MultiTargeting;
+    /** Lookalike audience targeting */
+    lookalike_audience_targeting?: MultiTargeting;
+    /** Contextual segments targeting */
+    contextual_segments_targeting?: MultiTargeting;
+    /** Marketing objective */
+    marketing_objective?: MarketingObjective;
+    /** Verification pixel config */
+    verification_pixel?: VerificationPixel;
+    /** Viewability tag config */
+    viewability_tag?: ViewabilityTag;
     /** Activity schedule */
     activity_schedule?: ActivitySchedule;
 }
@@ -618,35 +721,29 @@ interface CampaignListResponse {
         count: number;
     };
 }
-/**
- * Bulk campaign update request item
- */
-interface BulkCampaignUpdate {
-    /** Campaign ID to update */
-    campaign_id: string;
-    /** Fields to update */
-    update: UpdateCampaignRequest;
-}
 /**
  * Bulk campaign update request
  */
 interface BulkCampaignUpdateRequest {
-    campaigns: BulkCampaignUpdate[];
+    /** Campaign IDs to update */
+    campaigns: number[];
+    /** Order IDs to update (alternative to campaign IDs) */
+    order_ids?: string[];
+    /** Fields to update on all specified campaigns */
+    update: UpdateCampaignRequest;
 }
 /**
  * Campaign patch operation
  */
 type PatchOperation = 'ADD' | 'REMOVE' | 'REPLACE';
 /**
- * Campaign patch request for collections
+ * Campaign patch request
  */
 interface CampaignPatchRequest {
-    /** Operation type */
-    op: PatchOperation;
-    /** Path to the field */
-    path: string;
-    /** Value to set */
-    value: unknown;
+    /** Patch operation type */
+    patch_operation: PatchOperation;
+    /** Additional fields for the patch */
+    [key: string]: unknown;
 }
 /**
  * Campaign reach estimation request
@@ -723,6 +820,24 @@ interface CampaignTargetingCollection {
     value: string[];
     href?: string | null;
 }
+/**
+ * Settings for campaign duplication
+ */
+interface DuplicateSettings {
+    /** Whether to copy items from the source campaign */
+    copy_items?: boolean;
+    /** Whether to copy targeting from the source campaign */
+    copy_targeting?: boolean;
+}
+/**
+ * Campaign duplication request
+ */
+interface DuplicateCampaignRequest {
+    /** Name for the duplicated campaign */
+    name?: string;
+    /** Duplication settings */
+    duplicate_settings?: DuplicateSettings;
+}
 
 /**
  * Campaign Item (Ad) types for Taboola Backstage API
@@ -842,16 +957,33 @@ interface CampaignItem {
     logo?: Record<string, unknown>;
     /** Disclaimer text */
     disclaimer?: string;
+    /** Creative type */
+    creative_type?: string;
+    /** Image orientation */
+    orientation?: string;
+    /** Performance video data (motion ads) */
+    performance_video_data?: PerformanceVideoData;
+    /** Item start date */
+    start_date?: string;
+    /** Item end date */
+    end_date?: string;
 }
 /**
- * Create campaign item request
+ * Create campaign item request (static ads only)
  */
 interface CreateItemRequest {
     /** Landing page URL (required) */
     url: string;
-    /** Ad title/headline (required) */
-    title: string;
-    /** Thumbnail image URL (required unless uploading) */
+}
+/**
+ * Item data for bulk creation endpoints
+ */
+interface BulkCreateItemData {
+    /** Landing page URL (required) */
+    url: string;
+    /** Ad title/headline */
+    title?: string;
+    /** Thumbnail image URL (static ads) */
     thumbnail_url?: string;
     /** Ad description */
     description?: string;
@@ -863,6 +995,27 @@ interface CreateItemRequest {
     third_party_tags?: string[];
     /** RSS feed URL (creates RSS item) */
     rss_url?: string;
+    /** Performance video data (motion ads only) */
+    performance_video_data?: PerformanceVideoData;
+    /** Whether the item is active */
+    is_active?: boolean;
+    /** Creative crop configuration */
+    creative_crop?: Record<string, unknown>;
+    /** Verification pixel */
+    verification_pixel?: ItemVerificationPixel;
+    /** Viewability tag */
+    viewability_tag?: ItemViewabilityTag;
+}
+/**
+ * Performance video data for motion ads
+ */
+interface PerformanceVideoData {
+    /** URL to the video file (MP4 format) */
+    video_url: string;
+    /** URL to the fallback image (JPG/PNG format) */
+    fallback_url: string;
+    /** URL to the GIF preview */
+    gif_url?: string;
 }
 /**
  * Update campaign item request
@@ -870,18 +1023,31 @@ interface CreateItemRequest {
 interface UpdateItemRequest {
     /** Ad title */
     title?: string;
+    /** Landing page URL */
+    url?: string;
     /** Ad description */
     description?: string;
-    /** Thumbnail image URL */
+    /** Thumbnail image URL (static items only) */
     thumbnail_url?: string;
-    /** Whether item is active */
+    /** Whether item is active (use for pause/unpause) */
     is_active?: boolean;
     /** CTA configuration */
     cta?: CTA;
+    /**
+     * Creative focus configuration
+     * @deprecated This field has been deprecated
+     */
+    creative_focus?: CreativeFocus;
+    /** Verification pixel */
+    verification_pixel?: ItemVerificationPixel;
+    /** Viewability tag */
+    viewability_tag?: ItemViewabilityTag;
     /** Custom tracking data */
     custom_data?: string;
     /** Third-party tracking pixels */
     third_party_tags?: string[];
+    /** Performance video data (motion ads only) */
+    performance_video_data?: PerformanceVideoData;
 }
 /**
  * Campaign item list response
@@ -894,10 +1060,10 @@ interface CampaignItemListResponse {
     };
 }
 /**
- * Bulk item creation request
+ * Bulk item creation request (within a single campaign)
  */
 interface BulkCreateItemsRequest {
-    items: CreateItemRequest[];
+    items: BulkCreateItemData[];
 }
 /**
  * Bulk item creation response
@@ -905,7 +1071,7 @@ interface BulkCreateItemsRequest {
 interface BulkCreateItemsResponse {
     results: CampaignItem[];
     failed?: {
-        item: CreateItemRequest;
+        item: BulkCreateItemData;
         error: string;
     }[];
 }
@@ -918,8 +1084,18 @@ interface BulkUpdateItemsRequest {
         id: string;
         /** Campaign ID */
         campaign_id: string;
-        /** Fields to update */
-        update: UpdateItemRequest;
+        /** Ad title */
+        title?: string;
+        /** Landing page URL */
+        url?: string;
+        /** Ad description */
+        description?: string;
+        /** Thumbnail image URL */
+        thumbnail_url?: string;
+        /** Whether item is active */
+        is_active?: boolean;
+        /** CTA configuration */
+        cta?: CTA;
     }[];
 }
 /**
@@ -1015,7 +1191,6 @@ interface Country {
 interface Region {
     name: string;
     value: string;
-    country: string;
 }
 /**
  * DMA (Designated Market Area) - US only
@@ -1082,39 +1257,35 @@ interface MinimumCPC {
  * Marketplace audience segment
  */
 interface MarketplaceAudience {
-    id: string;
-    name: string;
+    taboola_audience_id: number;
+    audience_name: string;
     description: string | null;
-    provider: string | null;
-    data_partner_id: string | null;
-    parent_id: string | null;
-    has_children: boolean;
-    country: string | null;
-    platform: string | null;
-    full_path: string | null;
+    data_partner: string | null;
+    data_partner_audience_id: string | null;
+    allowed_countries: string[];
+    data_partner_group?: string | null;
+    taxonomy_categories?: string[] | null;
+    audience_size?: number | null;
 }
 /**
  * Lookalike audience
  */
 interface LookalikeAudience {
-    id: string;
-    name: string;
-    description: string | null;
-    source_audience_id: string | null;
-    status: string;
-    size: number | null;
-    country: string | null;
+    rule_id: number;
+    audience_name: string;
+    similarity_level_to_size: Record<number, number> | null;
 }
 /**
  * Contextual segment
  */
 interface ContextualSegment {
-    id: string;
-    name: string;
+    id: number;
+    label: string;
     description: string | null;
-    category: string | null;
-    parent_id: string | null;
-    has_children: boolean;
+    taxonomy: string | null;
+    provider?: string | null;
+    allowed_countries?: string[] | null;
+    size?: number | null;
 }
 /**
  * Campaign property enums response
@@ -1167,26 +1338,24 @@ interface ImageTaxonomy {
  * Publisher information
  */
 interface Publisher {
-    site: string;
-    site_id: string;
-    is_blocked: boolean;
+    id: number;
+    name: string;
+    account_id: string;
+    partner_types?: string[];
+    type?: string;
+    campaign_types?: string[];
+    currency?: CurrencyCode;
+    time_zone_name?: string;
 }
 /**
  * Response for listing publishers
  */
 type PublisherListResponse = ListResponse<Publisher>;
-/**
- * Blocked publisher at account level
- */
-interface BlockedPublisher {
-    site: string;
-    site_id: string;
-}
 /**
  * Response for blocked publishers
  */
 interface BlockedPublishersResponse {
-    results: BlockedPublisher[];
+    sites: string[];
 }
 /**
  * Request to update blocked publishers at account level
@@ -1201,107 +1370,93 @@ interface UpdateBlockedPublishersRequest {
  * Types for Taboola Backstage API campaign targeting including
  * postal codes, audience segments, and contextual targeting.
  */
-
 /**
- * Postal code targeting configuration
+ * Generic targeting restriction with include/exclude
  */
-interface PostalCodeTargeting {
-    type: 'INCLUDE' | 'EXCLUDE' | 'ALL';
-    values: PostalCodeValue[];
-    restrictions: PostalCodeRestrictions | null;
+interface TargetingRestriction<T> {
+    collection: T[];
+    type: 'INCLUDE' | 'EXCLUDE';
 }
 /**
- * Individual postal code value
+ * Lookalike audience item for targeting
  */
-interface PostalCodeValue {
-    postal_code: string;
-    country: string;
+interface LookalikeAudienceItem {
+    rule_id: number;
+    similarity_level: number;
 }
 /**
- * Postal code targeting restrictions
+ * Postal code targeting configuration
  */
-interface PostalCodeRestrictions {
-    max_postal_codes: number;
-    supported_countries: string[];
+interface PostalCodeTargeting {
+    type: 'INCLUDE' | 'EXCLUDE' | 'ALL';
+    collection: string[];
 }
 /**
  * Request to update postal code targeting
  */
 interface UpdatePostalCodeTargetingRequest {
     type: 'INCLUDE' | 'EXCLUDE' | 'ALL';
-    values: PostalCodeValue[];
-}
-/**
- * Audience segment for targeting
- */
-interface AudienceSegment {
-    id: string;
-    name: string | null;
+    collection: string[];
 }
 /**
- * Audience targeting configuration (marketplace, custom, lookalike)
+ * Audience targeting configuration (marketplace, custom)
  */
 interface AudienceTargeting {
-    collection: AudienceSegment[];
-    type: MultiTargetingState;
+    collection: TargetingRestriction<number>[];
 }
 /**
  * Request to update audience targeting
  */
 interface UpdateAudienceTargetingRequest {
-    type: MultiTargetingState;
-    collection?: AudienceSegment[] | undefined;
-    and_collection?: AudienceSegment[][] | undefined;
-    or_collection?: AudienceSegment[][] | undefined;
-}
-/**
- * Contextual segment for targeting
- */
-interface ContextualSegmentValue {
-    id: string;
-    name: string | null;
+    collection: TargetingRestriction<number>[];
 }
 /**
  * Contextual targeting configuration
  */
 interface ContextualTargeting {
-    type: MultiTargetingState;
-    collection: ContextualSegmentValue[];
+    collection: TargetingRestriction<number>[];
 }
 /**
  * Request to update contextual targeting
  */
 interface UpdateContextualTargetingRequest {
-    type: MultiTargetingState;
-    collection: ContextualSegmentValue[];
+    collection: TargetingRestriction<number>[];
 }
 /**
  * First party audience targeting
  */
 interface FirstPartyAudienceTargeting {
-    type: MultiTargetingState;
-    collection: AudienceSegment[];
+    collection: TargetingRestriction<number>[];
 }
 /**
  * Request to update first party audience targeting
  */
 interface UpdateFirstPartyAudienceTargetingRequest {
-    type: MultiTargetingState;
-    collection: AudienceSegment[];
+    collection: TargetingRestriction<number>[];
 }
 /**
  * Marking labels (pixel retargeting) targeting configuration
  */
 interface MarkingLabelsTargeting {
-    type: MultiTargetingState;
-    collection: string[];
+    collection: TargetingRestriction<string>[];
 }
 /**
  * Request to update marking labels targeting
  */
 interface UpdateMarkingLabelsTargetingRequest {
-    type: MultiTargetingState;
-    collection: string[];
+    collection: TargetingRestriction<string>[];
+}
+/**
+ * Lookalike audience targeting configuration
+ */
+interface LookalikeAudienceTargeting {
+    collection: TargetingRestriction<LookalikeAudienceItem>[];
+}
+/**
+ * Request to update lookalike audience targeting
+ */
+interface UpdateLookalikeAudienceTargetingRequest {
+    collection: TargetingRestriction<LookalikeAudienceItem>[];
 }
 
 /**
@@ -1315,11 +1470,14 @@ interface UpdateMarkingLabelsTargetingRequest {
  */
 interface CombinedAudience {
     id: string;
-    name: string;
+    display_name: string;
     description: string | null;
     status: CombinedAudienceStatus;
     created_at: string;
-    updated_at: string;
+    last_modified_at: string;
+    last_modified_by?: string;
+    advertiser_id?: string;
+    audience_size?: number | null;
     include_rules: CombinedAudienceRule[];
     exclude_rules: CombinedAudienceRule[];
 }
@@ -1337,7 +1495,7 @@ interface CombinedAudienceRule {
 /**
  * Type of audience in a combined audience rule
  */
-type CombinedAudienceType = 'CUSTOM_AUDIENCE' | 'LOOKALIKE_AUDIENCE' | 'MARKETPLACE_AUDIENCE' | 'FIRST_PARTY_AUDIENCE';
+type CombinedAudienceType = 'Custom' | 'Lookalike' | 'Third_Party' | 'First_Party';
 /**
  * Individual audience item in a rule
  */
@@ -1353,7 +1511,7 @@ type CombinedAudienceListResponse = ListResponse<CombinedAudience>;
  * Request to create a combined audience
  */
 interface CreateCombinedAudienceRequest {
-    name: string;
+    display_name: string;
     description?: string | undefined;
     include_rules: CombinedAudienceRule[];
     exclude_rules?: CombinedAudienceRule[] | undefined;
@@ -1362,7 +1520,7 @@ interface CreateCombinedAudienceRequest {
  * Request to update a combined audience
  */
 interface UpdateCombinedAudienceRequest {
-    name?: string | undefined;
+    display_name?: string | undefined;
     description?: string | undefined;
     include_rules?: CombinedAudienceRule[] | undefined;
     exclude_rules?: CombinedAudienceRule[] | undefined;
@@ -1371,11 +1529,14 @@ interface UpdateCombinedAudienceRequest {
  * Available audience for combined audience creation
  */
 interface AvailableAudience {
-    id: string;
-    name: string;
-    type: CombinedAudienceType;
+    id: number;
+    audience_name: string;
+    data_type: CombinedAudienceType;
     size: number | null;
     status: string;
+    provider?: string;
+    description?: string | null;
+    is_archived?: boolean;
 }
 /**
  * Response for listing available audiences
@@ -1386,15 +1547,22 @@ type AvailableAudiencesResponse = ListResponse<AvailableAudience>;
  */
 interface FirstPartyAudience {
     id: string;
-    name: string;
+    display_name: string;
     description: string | null;
     status: FirstPartyAudienceStatus;
-    size: number | null;
+    audience_size: number | null;
     match_rate: number | null;
     created_at: string;
-    updated_at: string;
-    ttl_days: number | null;
+    last_modified_at: string;
+    last_modified_by?: string;
+    ttl_in_hours: number | null;
+    ttl_type?: string;
     source_type: FirstPartyAudienceSourceType;
+    look_back_window?: number | null;
+    category?: string | null;
+    event_name?: string | null;
+    exclude_from_campaigns?: boolean;
+    advertiser_id?: string;
 }
 /**
  * First party audience status
@@ -1408,44 +1576,32 @@ type FirstPartyAudienceSourceType = 'CRM' | 'EMAIL' | 'PHONE' | 'DEVICE_ID' | 'C
  * Request to create a first party audience
  */
 interface CreateFirstPartyAudienceRequest {
-    name: string;
+    display_name: string;
     description?: string | undefined;
-    ttl_days?: number | undefined;
+    ttl_in_hours?: number | undefined;
     source_type: FirstPartyAudienceSourceType;
 }
 /**
- * User identifier for first party audience
+ * User identity item within a cluster
  */
-interface FirstPartyAudienceUser {
-    identifier_type: FirstPartyIdentifierType;
-    identifier_value: string;
-}
-/**
- * Type of user identifier
- */
-type FirstPartyIdentifierType = 'EMAIL' | 'EMAIL_SHA256' | 'PHONE' | 'PHONE_SHA256' | 'DEVICE_ID' | 'DEVICE_ID_SHA256';
-/**
- * Request to add or remove users from first party audience
- */
-interface AddRemoveUsersRequest {
-    add?: FirstPartyAudienceUser[] | undefined;
-    remove?: FirstPartyAudienceUser[] | undefined;
+interface AudienceUserClusterItem {
+    user_id: string;
+    type: string;
+    is_hashed: boolean;
 }
 /**
- * Response for add/remove users operation
+ * User identity cluster
  */
-interface AddRemoveUsersResponse {
-    added_count: number;
-    removed_count: number;
-    failed_count: number;
-    errors: AddRemoveUserError[];
+interface AudienceUserIdentity {
+    cluster: AudienceUserClusterItem[];
 }
 /**
- * Error from add/remove users operation
+ * Request to add or remove users from first party audience
  */
-interface AddRemoveUserError {
-    identifier: string;
-    error: string;
+interface AudienceUsersRequest {
+    operation: 'ADD' | 'REMOVE';
+    audience_id: number;
+    identities: AudienceUserIdentity[];
 }
 
 /**
@@ -1459,74 +1615,62 @@ interface AddRemoveUserError {
  * Conversion rule for tracking conversions
  */
 interface ConversionRule {
-    id: string;
+    id: number;
     display_name: string;
-    status: ConversionRuleStatus;
+    advertiser_id: string;
     type: ConversionRuleType;
-    include_in_total_conversions: boolean;
-    include_in_total_value: boolean;
-    category: ConversionCategory | null;
-    conversion_window_days: number;
-    view_through_window_days: number;
-    counting_method: CountingMethod;
-    aggregation_type: AggregationType;
-    default_conversion_value: number | null;
-    conditions: Condition[];
-    effect: Effect;
+    status: ConversionRuleStatus;
     event_name: string | null;
-    created_at: string;
-    updated_at: string;
+    category: ConversionCategory | null;
+    description: string | null;
+    look_back_window: number;
+    view_through_look_back_window: number | null;
+    condition: ConversionCondition;
+    effects: ConversionEffect[];
+    include_in_total_conversions: boolean;
+    exclude_from_campaigns: boolean;
+    last_modified_by: string;
+    last_modified_at: string;
 }
 /**
  * Conversion rule status
  */
-type ConversionRuleStatus = 'ACTIVE' | 'ARCHIVED';
+type ConversionRuleStatus = 'ACTIVE' | 'DISABLED' | 'ARCHIVED';
 /**
  * Conversion rule type
+ *
+ * - BASIC: URL-based conversion rules using the condition object
+ * - EVENT_BASED: Custom event-based rules using event_name
  */
-type ConversionRuleType = 'EVENT_BASED' | 'URL_BASED' | 'CUSTOM';
+type ConversionRuleType = 'BASIC' | 'EVENT_BASED';
 /**
  * Conversion category
  */
-type ConversionCategory = 'PURCHASE' | 'LEAD' | 'SIGN_UP' | 'ADD_TO_CART' | 'CHECKOUT' | 'CONTENT_VIEW' | 'SEARCH' | 'ADD_PAYMENT_INFO' | 'SUBSCRIBE' | 'PAGE_VIEW' | 'COMPLETE_REGISTRATION' | 'OTHER';
-/**
- * Counting method for conversions
- */
-type CountingMethod = 'ALL' | 'ONE';
-/**
- * Aggregation type for conversion values
- */
-type AggregationType = 'SUM' | 'COUNT';
+type ConversionCategory = 'VIEW_CONTENT' | 'SEARCH' | 'ADD_TO_CART' | 'ADD_TO_WISHLIST' | 'START_CHECKOUT' | 'ADD_PAYMENT_INFO' | 'MAKE_PURCHASE' | 'LEAD' | 'COMPLETE_REGISTRATION' | 'APP_INSTALL' | 'OTHER';
 /**
- * Condition for matching conversions
+ * Condition for matching conversions (tree structure)
+ *
+ * For a single condition, property/predicate/value are set directly.
+ * For multiple conditions, the parent has predicate 'OR' and individual
+ * conditions are in the children array.
  */
-interface Condition {
-    type: ConditionType;
-    operator: ConditionOperator;
-    value: string;
-    parameter?: string | undefined;
+interface ConversionCondition {
+    property: string | null;
+    predicate: ConversionConditionPredicate;
+    value: string | null;
+    children: ConversionCondition[];
 }
 /**
- * Condition type
+ * Condition predicate
  */
-type ConditionType = 'URL' | 'URL_PARAMETER' | 'EVENT_NAME' | 'EVENT_PARAMETER';
-/**
- * Condition operator
- */
-type ConditionOperator = 'EQUALS' | 'NOT_EQUALS' | 'CONTAINS' | 'NOT_CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH' | 'REGEX';
+type ConversionConditionPredicate = 'CONTAINS' | 'EQUALS' | 'OR';
 /**
  * Effect of matching a conversion rule
  */
-interface Effect {
-    type: EffectType;
-    value: number | null;
-    currency: string | null;
-    value_parameter: string | null;
+interface ConversionEffect {
+    type: string;
+    data: string;
 }
-/**
- * Effect type
- */
-type EffectType = 'FIXED_VALUE' | 'DYNAMIC_VALUE' | 'NO_VALUE';
 /**
  * Response for listing conversion rules
  */
@@ -1537,34 +1681,32 @@ type ConversionRuleListResponse = ListResponse<ConversionRule>;
 interface CreateConversionRuleRequest {
     display_name: string;
     type: ConversionRuleType;
-    include_in_total_conversions?: boolean | undefined;
-    include_in_total_value?: boolean | undefined;
-    category?: ConversionCategory | undefined;
-    conversion_window_days?: number | undefined;
-    view_through_window_days?: number | undefined;
-    counting_method?: CountingMethod | undefined;
-    aggregation_type?: AggregationType | undefined;
-    default_conversion_value?: number | undefined;
-    conditions: Condition[];
-    effect: Effect;
     event_name?: string | undefined;
+    category?: ConversionCategory | undefined;
+    description?: string | undefined;
+    look_back_window?: number | undefined;
+    view_through_look_back_window?: number | undefined;
+    condition?: ConversionCondition | undefined;
+    effects?: ConversionEffect[] | undefined;
+    include_in_total_conversions?: boolean | undefined;
+    exclude_from_campaigns?: boolean | undefined;
 }
 /**
  * Request to update a conversion rule
+ *
+ * Note: type and advertiser_id are final and cannot be changed after creation.
  */
 interface UpdateConversionRuleRequest {
     display_name?: string | undefined;
     status?: ConversionRuleStatus | undefined;
-    include_in_total_conversions?: boolean | undefined;
-    include_in_total_value?: boolean | undefined;
     category?: ConversionCategory | undefined;
-    conversion_window_days?: number | undefined;
-    view_through_window_days?: number | undefined;
-    counting_method?: CountingMethod | undefined;
-    aggregation_type?: AggregationType | undefined;
-    default_conversion_value?: number | undefined;
-    conditions?: Condition[] | undefined;
-    effect?: Effect | undefined;
+    description?: string | undefined;
+    look_back_window?: number | undefined;
+    view_through_look_back_window?: number | undefined;
+    condition?: ConversionCondition | undefined;
+    effects?: ConversionEffect[] | undefined;
+    include_in_total_conversions?: boolean | undefined;
+    exclude_from_campaigns?: boolean | undefined;
 }
 /**
  * Custom audience rule for building audiences from pixel data
@@ -1573,7 +1715,7 @@ interface CustomAudienceRule {
     id: string;
     display_name: string;
     status: CustomAudienceRuleStatus;
-    conditions: Condition[];
+    conditions: CustomAudienceCondition[];
     ttl_days: number;
     size: number | null;
     created_at: string;
@@ -1583,6 +1725,23 @@ interface CustomAudienceRule {
  * Custom audience rule status
  */
 type CustomAudienceRuleStatus = 'ACTIVE' | 'PAUSED' | 'ARCHIVED';
+/**
+ * Condition for custom audience rules
+ */
+interface CustomAudienceCondition {
+    type: CustomAudienceConditionType;
+    operator: CustomAudienceConditionOperator;
+    value: string;
+    parameter?: string | undefined;
+}
+/**
+ * Custom audience condition type
+ */
+type CustomAudienceConditionType = 'URL' | 'URL_PARAMETER' | 'EVENT_NAME' | 'EVENT_PARAMETER';
+/**
+ * Custom audience condition operator
+ */
+type CustomAudienceConditionOperator = 'EQUALS' | 'NOT_EQUALS' | 'CONTAINS' | 'NOT_CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH' | 'REGEX';
 /**
  * Response for listing custom audience rules
  */
@@ -1592,7 +1751,7 @@ type CustomAudienceRuleListResponse = ListResponse<CustomAudienceRule>;
  */
 interface CreateCustomAudienceRuleRequest {
     display_name: string;
-    conditions: Condition[];
+    conditions: CustomAudienceCondition[];
     ttl_days?: number | undefined;
 }
 /**
@@ -1601,16 +1760,19 @@ interface CreateCustomAudienceRuleRequest {
 interface UpdateCustomAudienceRuleRequest {
     display_name?: string | undefined;
     status?: CustomAudienceRuleStatus | undefined;
-    conditions?: Condition[] | undefined;
+    conditions?: CustomAudienceCondition[] | undefined;
     ttl_days?: number | undefined;
 }
 /**
- * Conversion rule with additional performance data
+ * Conversion rule wrapped with performance data
+ *
+ * Returned by the /data endpoint which wraps each rule
+ * with last_received and total_received metrics.
  */
-interface ConversionRuleWithData extends ConversionRule {
-    conversions_30d: number;
-    conversions_value_30d: number;
-    last_conversion_at: string | null;
+interface ConversionRuleWithData {
+    last_received: string | null;
+    total_received: number;
+    unip_conversion_rule: ConversionRule;
 }
 /**
  * Response for listing conversion rules with data
@@ -1904,6 +2066,10 @@ interface CampaignSummaryRow {
     conversions_value: number;
     /** Return on ad spend */
     roas: number;
+    /** ROAS from clicks */
+    roas_clicks?: number | undefined;
+    /** ROAS from views */
+    roas_views?: number | undefined;
     /** Cost per action (all) */
     cpa: number;
     /** CPA from clicks */
@@ -1928,6 +2094,16 @@ interface CampaignSummaryRow {
     audience_name?: string | undefined;
     /** Data partner audience ID (for user_segment_breakdown dimension) */
     data_partner_audience_id?: string | undefined;
+    /** Campaign learning state */
+    campaign_learning_state?: string | undefined;
+    /** Audience description */
+    audience_description?: string | undefined;
+    /** OS family (for os_family_breakdown dimension) */
+    os_family?: string | undefined;
+    /** OS version (for os_version_breakdown dimension) */
+    os_version?: string | undefined;
+    /** Browser (for browser_breakdown dimension) */
+    browser?: string | undefined;
     /** Custom conversion columns (dynamic based on include_conversions) */
     [key: string]: unknown;
 }
@@ -1959,6 +2135,16 @@ interface TopCampaignContentRow {
     /** Content provider (publisher) */
     content_provider?: string | undefined;
     content_provider_name?: string | undefined;
+    /** Ad description */
+    description?: string | undefined;
+    /** Creation time */
+    create_time?: string | undefined;
+    /** Learning display status */
+    learning_display_status?: string | undefined;
+    /** Ad name */
+    ad_name?: string | undefined;
+    /** Custom ID */
+    custom_id?: string | undefined;
     /** Metrics */
     clicks: number;
     impressions: number;
@@ -1977,8 +2163,6 @@ interface TopCampaignContentRow {
     conversions_value: number;
     roas: number;
     cpa: number;
-    cpa_actions_num: number;
-    cpa_conversion_rate: number;
     /** Custom conversion columns */
     [key: string]: unknown;
 }
@@ -1999,22 +2183,24 @@ interface RealtimeCampaignReport {
  * Fields present depend on the chosen dimension.
  */
 interface RealtimeCampaignRow {
-    /** Hour (for by_hour dimensions) */
-    hour?: string | undefined;
+    /** Date/time bucket */
+    date?: string | undefined;
     /** Campaign ID (for by_campaign dimensions) */
-    campaign?: string | undefined;
+    campaign_id?: string | undefined;
     campaign_name?: string | undefined;
     /** Site name (for by_site dimensions) */
-    site?: string | undefined;
+    site_name?: string | undefined;
     site_id?: string | undefined;
     /** Country code (for by_country dimensions) */
     country?: string | undefined;
+    /** Country name */
+    country_name?: string | undefined;
     /** Platform (for by_platform dimensions) */
     platform?: string | undefined;
+    /** Platform name */
+    platform_name?: string | undefined;
     /** Number of clicks */
     clicks: number;
-    /** Number of impressions */
-    impressions: number;
     /** Number of visible impressions */
     visible_impressions: number;
     /** Total spend */
@@ -2037,6 +2223,10 @@ interface RealtimeCampaignRow {
     cpa_conversion_rate: number;
     /** Cost per action */
     cpa: number;
+    /** Total conversion value */
+    conversions_value?: number | undefined;
+    /** Return on ad spend */
+    roas?: number | undefined;
     /** Dynamic fields (e.g. from fetch_config) */
     [key: string]: unknown;
 }
@@ -2056,17 +2246,23 @@ interface RealtimeAdsReport {
  */
 interface RealtimeAdsRow {
     /** Item (ad) ID */
-    item: string;
+    item_id: string;
     item_name: string;
     /** Thumbnail URL */
     thumbnail_url: string;
     /** Campaign ID */
-    campaign: string;
+    campaign_id: string;
     campaign_name: string;
+    /** Ad description */
+    description?: string | undefined;
+    /** Landing page URL */
+    url?: string | undefined;
+    /** Item type */
+    item_type?: string | undefined;
+    /** Date/time bucket */
+    date?: string | undefined;
     /** Number of clicks */
     clicks: number;
-    /** Number of impressions */
-    impressions: number;
     /** Number of visible impressions */
     visible_impressions: number;
     /** Total spend */
@@ -2089,6 +2285,10 @@ interface RealtimeAdsRow {
     cpa_conversion_rate: number;
     /** Cost per action */
     cpa: number;
+    /** Total conversion value */
+    conversions_value?: number | undefined;
+    /** Return on ad spend */
+    roas?: number | undefined;
     /** Dynamic fields */
     [key: string]: unknown;
 }
@@ -2111,7 +2311,7 @@ interface ReportField {
 /**
  * Report data type
  */
-type ReportDataType = 'DATE' | 'STRING' | 'NUMERIC' | 'CURRENCY' | 'PERCENTAGE';
+type ReportDataType = 'STRING' | 'FLOAT' | 'MONEY' | 'PERCENT' | 'NUMERIC' | 'DATA' | 'DATE' | 'TIMESTAMP' | 'URL' | 'BOOLEAN';
 
 /**
  * Account API for Taboola Backstage
@@ -2205,217 +2405,69 @@ declare class CampaignsAPI {
     constructor(http: HttpClient);
     /**
      * List all campaigns for an account
-     *
-     * @param accountId - Account ID
-     * @param options - Pagination and filter options
-     *
-     * @example
-     * ```typescript
-     * const { results } = await client.campaigns.list('my-account');
-     * for (const campaign of results) {
-     *   console.log(campaign.name, campaign.status);
-     * }
-     * ```
      */
     list(accountId: string, options?: ListCampaignsOptions): Promise<CampaignListResponse>;
     /**
      * List all campaigns with base (partial) fields only
-     *
-     * Returns a lighter-weight response with fewer fields per campaign.
-     * Useful for listing/overview pages where full campaign data is not needed.
-     *
-     * @param accountId - Account ID
-     *
-     * @example
-     * ```typescript
-     * const { results } = await client.campaigns.listBase('my-account');
-     * for (const campaign of results) {
-     *   console.log(campaign.name, campaign.status);
-     * }
-     * ```
      */
     listBase(accountId: string): Promise<CampaignBaseListResponse>;
     /**
      * Get a single campaign by ID
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     *
-     * @example
-     * ```typescript
-     * const campaign = await client.campaigns.get('my-account', '12345');
-     * console.log(campaign.name, campaign.cpc);
-     * ```
      */
     get(accountId: string, campaignId: string): Promise<Campaign>;
     /**
      * Create a new campaign
-     *
-     * @param accountId - Account ID
-     * @param campaign - Campaign data
-     *
-     * @example
-     * ```typescript
-     * const campaign = await client.campaigns.create('my-account', {
-     *   name: 'My New Campaign',
-     *   branding_text: 'My Brand',
-     *   cpc: 0.50,
-     *   spending_limit: 1000,
-     *   spending_limit_model: 'MONTHLY',
-     *   marketing_objective: 'DRIVE_WEBSITE_TRAFFIC',
-     * });
-     * console.log('Created campaign:', campaign.id);
-     * ```
      */
     create(accountId: string, campaign: CreateCampaignRequest): Promise<Campaign>;
     /**
      * Update an existing campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param updates - Fields to update
-     *
-     * @example
-     * ```typescript
-     * const campaign = await client.campaigns.update('my-account', '12345', {
-     *   cpc: 0.75,
-     *   daily_cap: 500,
-     * });
-     * ```
      */
     update(accountId: string, campaignId: string, updates: UpdateCampaignRequest): Promise<Campaign>;
     /**
      * Delete a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     *
-     * @example
-     * ```typescript
-     * await client.campaigns.delete('my-account', '12345');
-     * ```
      */
     delete(accountId: string, campaignId: string): Promise<void>;
     /**
      * Duplicate a campaign
      *
-     * Creates a copy of an existing campaign with a new name.
-     *
      * @param accountId - Account ID
      * @param campaignId - Campaign ID to duplicate
-     * @param newName - Name for the new campaign
-     *
-     * @example
-     * ```typescript
-     * const newCampaign = await client.campaigns.duplicate(
-     *   'my-account',
-     *   '12345',
-     *   'My Campaign - Copy'
-     * );
-     * ```
+     * @param request - Duplication request with optional name and settings
+     * @param destinationAccount - Optional destination account ID for cross-account duplication
      */
-    duplicate(accountId: string, campaignId: string, newName: string): Promise<Campaign>;
+    duplicate(accountId: string, campaignId: string, request: DuplicateCampaignRequest, destinationAccount?: string): Promise<Campaign>;
     /**
      * Pause a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     *
-     * @example
-     * ```typescript
-     * await client.campaigns.pause('my-account', '12345');
-     * ```
      */
     pause(accountId: string, campaignId: string): Promise<Campaign>;
     /**
      * Unpause (resume) a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     *
-     * @example
-     * ```typescript
-     * await client.campaigns.unpause('my-account', '12345');
-     * ```
      */
     unpause(accountId: string, campaignId: string): Promise<Campaign>;
     /**
      * Bulk update multiple campaigns
-     *
-     * @param accountId - Account ID
-     * @param updates - Array of campaign updates
-     *
-     * @example
-     * ```typescript
-     * await client.campaigns.bulkUpdate('my-account', {
-     *   campaigns: [
-     *     { campaign_id: '12345', update: { is_active: false } },
-     *     { campaign_id: '12346', update: { is_active: false } },
-     *   ],
-     * });
-     * ```
      */
     bulkUpdate(accountId: string, updates: BulkCampaignUpdateRequest): Promise<CampaignListResponse>;
     /**
-     * Patch a campaign collection (targeting, bid modifiers, etc.)
+     * Patch a campaign
      *
      * @param accountId - Account ID
      * @param campaignId - Campaign ID
-     * @param collection - Collection name (e.g., 'publisher_targeting')
-     * @param patches - Patch operations
-     *
-     * @example
-     * ```typescript
-     * await client.campaigns.patch('my-account', '12345', 'publisher_targeting', [
-     *   { op: 'ADD', path: '/value', value: ['pub-123'] },
-     * ]);
-     * ```
+     * @param patch - Patch operation
      */
-    patch(accountId: string, campaignId: string, collection: string, patches: CampaignPatchRequest[]): Promise<Campaign>;
+    patch(accountId: string, campaignId: string, patch: CampaignPatchRequest): Promise<Campaign>;
     /**
      * Get all campaigns across a network
      *
      * @param networkAccountId - Network account ID
-     *
-     * @example
-     * ```typescript
-     * const { results } = await client.campaigns.listNetwork('my-network');
-     * ```
      */
-    listNetwork(networkAccountId: string): Promise<CampaignListResponse>;
+    listNetwork(networkAccountId: string): Promise<CampaignBaseListResponse>;
     /**
      * Estimate campaign reach
-     *
-     * Get estimated impressions, clicks, and reach for a campaign configuration.
-     *
-     * @param accountId - Account ID
-     * @param params - Targeting and budget parameters
-     *
-     * @example
-     * ```typescript
-     * const estimate = await client.campaigns.estimateReach('my-account', {
-     *   country_targeting: ['US'],
-     *   platform_targeting: ['DESK', 'PHON'],
-     *   daily_cap: 100,
-     *   cpc: 0.50,
-     * });
-     * console.log('Estimated clicks:', estimate.estimated_clicks);
-     * ```
      */
     estimateReach(accountId: string, params: CampaignReachEstimatorRequest): Promise<CampaignReachEstimatorResponse>;
     /**
      * Get publisher targeting whitelist for a campaign
-     *
-     * Returns the list of publishers that are whitelisted for this campaign.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     *
-     * @example
-     * ```typescript
-     * const whitelist = await client.campaigns.getTargetingWhitelist('my-account', '12345');
-     * console.log('Whitelisted publishers:', whitelist.value);
-     * ```
      */
     getTargetingWhitelist(accountId: string, campaignId: string): Promise<CampaignTargetingCollection>;
 }
@@ -2474,40 +2526,68 @@ declare class ItemsAPI {
      */
     get(accountId: string, campaignId: string, itemId: string): Promise<CampaignItem>;
     /**
-     * Create a new item (ad) in a campaign
+     * Create a new item (static ad) in a campaign
+     *
+     * Only the `url` field is accepted. The item is created with a status of CRAWLING
+     * (read-only). Poll until the status changes to RUNNING or NEED_TO_EDIT, then
+     * use `update()` to modify fields.
+     *
+     * For creating items with more fields upfront, or for motion ads,
+     * use `bulkCreateAcrossCampaigns()` instead.
      *
      * @param accountId - Account ID
      * @param campaignId - Campaign ID
-     * @param item - Item data
+     * @param item - Item data (only `url` is accepted)
      *
      * @example
      * ```typescript
      * const item = await client.items.create('my-account', '12345', {
      *   url: 'https://example.com/landing-page',
-     *   title: 'Check Out Our Amazing Product!',
-     *   thumbnail_url: 'https://example.com/image.jpg',
-     *   description: 'Learn more about our product',
-     *   cta: { cta_type: 'LEARN_MORE' },
      * });
-     * console.log('Created item:', item.id);
+     * // Item starts in CRAWLING state - poll until status changes
+     * console.log('Created item:', item.id, item.status); // CRAWLING
      * ```
      */
     create(accountId: string, campaignId: string, item: CreateItemRequest): Promise<CampaignItem>;
     /**
-     * Update an existing item
+     * Update an existing item (static or motion ad)
+     *
+     * Submit only the fields you want to update. Fields that are omitted or null
+     * will remain unchanged. The endpoint automatically detects the item type.
+     *
+     * Note: While status is CRAWLING, the Item is in a read-only state - no fields can be modified.
      *
      * @param accountId - Account ID
      * @param campaignId - Campaign ID
      * @param itemId - Item ID
-     * @param updates - Fields to update
+     * @param updates - Fields to update (partial)
      *
-     * @example
+     * @example Update a static item
      * ```typescript
      * const item = await client.items.update('my-account', '12345', '67890', {
      *   title: 'Updated Title!',
      *   is_active: true,
      * });
      * ```
+     *
+     * @example Update a motion ad
+     * ```typescript
+     * const item = await client.items.update('my-account', '12345', '67890', {
+     *   title: 'Updated Motion Ad Title',
+     *   description: 'New description',
+     *   performance_video_data: {
+     *     video_url: 'https://example.com/video.mp4',
+     *     fallback_url: 'https://example.com/fallback.jpg',
+     *   },
+     * });
+     * ```
+     *
+     * @example Pause an item (alternatively, use pause() method)
+     * ```typescript
+     * const item = await client.items.update('my-account', '12345', '67890', {
+     *   is_active: false,
+     * });
+     * ```
      */
     update(accountId: string, campaignId: string, itemId: string, updates: UpdateItemRequest): Promise<CampaignItem>;
     /**
@@ -2550,11 +2630,13 @@ declare class ItemsAPI {
      */
     unpause(accountId: string, campaignId: string, itemId: string): Promise<CampaignItem>;
     /**
-     * Create multiple items at once (mass create)
+     * Create multiple items at once within a single campaign (mass create)
+     *
+     * Supports both static ads and motion ads via the bulk item data format.
      *
      * @param accountId - Account ID
      * @param campaignId - Campaign ID
-     * @param items - Array of items to create
+     * @param request - Bulk create request with items array
      *
      * @example
      * ```typescript
@@ -2571,18 +2653,35 @@ declare class ItemsAPI {
     /**
      * Bulk create items across multiple campaigns
      *
+     * Unified endpoint that supports both static ads and motion ads.
+     *
      * @param accountId - Account ID
      * @param items - Array of items with campaign IDs
      *
-     * @example
+     * @example Static ads
+     * ```typescript
+     * await client.items.bulkCreateAcrossCampaigns('my-account', [
+     *   { campaign_id: '12345', url: 'https://example.com/1', title: 'Title 1' },
+     *   { campaign_id: '12346', url: 'https://example.com/2', title: 'Title 2' },
+     * ]);
+     * ```
+     *
+     * @example Motion ads
      * ```typescript
      * await client.items.bulkCreateAcrossCampaigns('my-account', [
-     *   { campaign_id: '12345', url: '...', title: '...' },
-     *   { campaign_id: '12346', url: '...', title: '...' },
+     *   {
+     *     campaign_id: '12345',
+     *     url: 'https://example.com/1',
+     *     title: 'Motion Ad',
+     *     performance_video_data: {
+     *       video_url: 'https://example.com/video.mp4',
+     *       fallback_url: 'https://example.com/fallback.jpg',
+     *     },
+     *   },
      * ]);
      * ```
      */
-    bulkCreateAcrossCampaigns(accountId: string, items: (CreateItemRequest & {
+    bulkCreateAcrossCampaigns(accountId: string, items: (BulkCreateItemData & {
         campaign_id: string;
     })[]): Promise<BulkCreateItemsResponse>;
     /**
@@ -2673,22 +2772,14 @@ declare class DictionaryAPI {
     getCountries(): Promise<Country[]>;
     /**
      * Get regions/states within a country
-     *
-     * @param countryCode - Country code (e.g., 'US', 'GB')
      */
     getRegions(countryCode: string): Promise<Region[]>;
     /**
      * Get DMAs (Designated Market Areas) for a country
-     * Note: Only available for US
-     *
-     * @param countryCode - Country code (typically 'US')
      */
     getDMAs(countryCode: string): Promise<DMA[]>;
     /**
      * Get postal codes for a country
-     *
-     * @param countryCode - Country code (e.g., 'US', 'GB')
-     * @param params - Optional search and pagination parameters
      */
     getPostalCodes(countryCode: string, params?: PostalCodeSearchParams): Promise<PostalCode[]>;
     /**
@@ -2745,40 +2836,26 @@ declare class DictionaryAPI {
     getImageLibraryLanguages(): Promise<ImageLibraryLanguage[]>;
     /**
      * Get image taxonomies for categorizing images
-     *
-     * @param accountId - Account ID
      */
     getImageTaxonomies(accountId: string): Promise<ImageTaxonomy[]>;
     /**
      * Get marketplace audience segments available for targeting
-     *
-     * @param accountId - Account ID
      */
     getMarketplaceAudiences(accountId: string): Promise<MarketplaceAudience[]>;
     /**
      * Get marketplace audience segments for a specific country
-     *
-     * @param accountId - Account ID
-     * @param countryCode - Country code (e.g., 'US', 'GB')
      */
     getMarketplaceAudiencesByCountry(accountId: string, countryCode: string): Promise<MarketplaceAudience[]>;
     /**
      * Get lookalike audiences available for targeting
-     *
-     * @param accountId - Account ID
      */
     getLookalikeAudiences(accountId: string): Promise<LookalikeAudience[]>;
     /**
      * Get lookalike audiences for a specific country
-     *
-     * @param accountId - Account ID
-     * @param countryCode - Country code (e.g., 'US', 'GB')
      */
     getLookalikeAudiencesByCountry(accountId: string, countryCode: string): Promise<LookalikeAudience[]>;
     /**
      * Get contextual segments available for targeting
-     *
-     * @param accountId - Account ID
      */
     getContextualSegments(accountId: string): Promise<ContextualSegment[]>;
 }
@@ -2799,84 +2876,31 @@ declare class PublishersAPI {
     constructor(http: HttpClient);
     /**
      * List all available publishers for an account
-     *
-     * @param accountId - Account ID
-     * @returns List of publishers with blocking status
-     *
-     * @example
-     * ```typescript
-     * const publishers = await client.publishers.list('my-account');
-     * console.log(`Found ${publishers.length} publishers`);
-     * ```
      */
     list(accountId: string): Promise<Publisher[]>;
     /**
      * Get blocked publishers at the account level
-     *
-     * @param accountId - Account ID
-     * @returns List of blocked publishers
-     *
-     * @example
-     * ```typescript
-     * const blocked = await client.publishers.getBlocked('my-account');
-     * console.log(`${blocked.length} publishers blocked at account level`);
-     * ```
      */
-    getBlocked(accountId: string): Promise<BlockedPublisher[]>;
+    getBlocked(accountId: string): Promise<string[]>;
     /**
      * Update blocked publishers at the account level
      *
      * This replaces the current list of blocked publishers with the
-     * provided list. To add to existing blocks, first get the current
-     * list and append.
-     *
-     * @param accountId - Account ID
-     * @param sites - Array of site names to block
-     * @returns Updated list of blocked publishers
-     *
-     * @example
-     * ```typescript
-     * // Block specific publishers
-     * await client.publishers.updateBlocked('my-account', {
-     *   sites: ['site1.com', 'site2.com']
-     * });
-     *
-     * // Add to existing blocks
-     * const current = await client.publishers.getBlocked('my-account');
-     * const currentSites = current.map(p => p.site);
-     * await client.publishers.updateBlocked('my-account', {
-     *   sites: [...currentSites, 'newsite.com']
-     * });
-     * ```
+     * provided list.
      */
-    updateBlocked(accountId: string, request: UpdateBlockedPublishersRequest): Promise<BlockedPublisher[]>;
+    updateBlocked(accountId: string, request: UpdateBlockedPublishersRequest): Promise<string[]>;
     /**
      * Block a single publisher at the account level
-     *
-     * Convenience method that adds a publisher to the existing block list.
-     *
-     * @param accountId - Account ID
-     * @param site - Site name to block
-     * @returns Updated list of blocked publishers
      */
-    blockPublisher(accountId: string, site: string): Promise<BlockedPublisher[]>;
+    blockPublisher(accountId: string, site: string): Promise<string[]>;
     /**
      * Unblock a single publisher at the account level
-     *
-     * Convenience method that removes a publisher from the block list.
-     *
-     * @param accountId - Account ID
-     * @param site - Site name to unblock
-     * @returns Updated list of blocked publishers
      */
-    unblockPublisher(accountId: string, site: string): Promise<BlockedPublisher[]>;
+    unblockPublisher(accountId: string, site: string): Promise<string[]>;
     /**
      * Clear all blocked publishers at the account level
-     *
-     * @param accountId - Account ID
-     * @returns Empty list
      */
-    clearBlocked(accountId: string): Promise<BlockedPublisher[]>;
+    clearBlocked(accountId: string): Promise<string[]>;
 }
 
 /**
@@ -2895,192 +2919,58 @@ declare class TargetingAPI {
     constructor(http: HttpClient);
     /**
      * Get postal code targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Postal code targeting configuration
-     *
-     * @example
-     * ```typescript
-     * const targeting = await client.targeting.getPostalCodes('my-account', '12345');
-     * console.log(`Targeting type: ${targeting.type}`);
-     * console.log(`Postal codes: ${targeting.values.length}`);
-     * ```
      */
     getPostalCodes(accountId: string, campaignId: string): Promise<PostalCodeTargeting>;
     /**
      * Update postal code targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Postal code targeting configuration
-     * @returns Updated targeting configuration
-     *
-     * @example
-     * ```typescript
-     * await client.targeting.updatePostalCodes('my-account', '12345', {
-     *   type: 'INCLUDE',
-     *   values: [
-     *     { postal_code: '10001', country: 'US' },
-     *     { postal_code: '10002', country: 'US' },
-     *   ]
-     * });
-     * ```
      */
     updatePostalCodes(accountId: string, campaignId: string, targeting: UpdatePostalCodeTargetingRequest): Promise<PostalCodeTargeting>;
     /**
      * Get marketplace audience targeting for a campaign
-     *
-     * Marketplace audiences are third-party audience segments
-     * available for targeting through Taboola's marketplace.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Audience targeting configuration
      */
     getMarketplaceAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
     /**
      * Update marketplace audience targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Audience targeting configuration
-     * @returns Updated targeting configuration
-     *
-     * @example
-     * ```typescript
-     * await client.targeting.updateMarketplaceAudiences('my-account', '12345', {
-     *   type: 'INCLUDE',
-     *   collection: [
-     *     { id: 'segment-1', name: null },
-     *     { id: 'segment-2', name: null },
-     *   ]
-     * });
-     * ```
      */
     updateMarketplaceAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
     /**
      * Get custom audience targeting for a campaign
-     *
-     * Custom audiences are audiences created from pixel data
-     * or uploaded lists.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Audience targeting configuration
      */
     getCustomAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
     /**
      * Update custom audience targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Audience targeting configuration
-     * @returns Updated targeting configuration
      */
     updateCustomAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
     /**
      * Get lookalike audience targeting for a campaign
-     *
-     * Lookalike audiences are modeled after your existing
-     * custom audiences to find similar users.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Audience targeting configuration
      */
-    getLookalikeAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
+    getLookalikeAudiences(accountId: string, campaignId: string): Promise<LookalikeAudienceTargeting>;
     /**
      * Update lookalike audience targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Audience targeting configuration
-     * @returns Updated targeting configuration
      */
-    updateLookalikeAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
+    updateLookalikeAudiences(accountId: string, campaignId: string, targeting: UpdateLookalikeAudienceTargetingRequest): Promise<LookalikeAudienceTargeting>;
     /**
      * Get contextual targeting for a campaign
-     *
-     * Contextual targeting allows you to target based on the
-     * content of the pages where your ads appear.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Contextual targeting configuration
      */
     getContextual(accountId: string, campaignId: string): Promise<ContextualTargeting>;
     /**
      * Update contextual targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Contextual targeting configuration
-     * @returns Updated targeting configuration
-     *
-     * @example
-     * ```typescript
-     * await client.targeting.updateContextual('my-account', '12345', {
-     *   type: 'INCLUDE',
-     *   collection: [
-     *     { id: 'context-1', name: null },
-     *     { id: 'context-2', name: null },
-     *   ]
-     * });
-     * ```
      */
     updateContextual(accountId: string, campaignId: string, targeting: UpdateContextualTargetingRequest): Promise<ContextualTargeting>;
     /**
      * Get first party audience targeting for a campaign
-     *
-     * First party audiences are your own uploaded audience data.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns First party audience targeting configuration
      */
     getFirstPartyAudiences(accountId: string, campaignId: string): Promise<FirstPartyAudienceTargeting>;
     /**
      * Update first party audience targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - First party audience targeting configuration
-     * @returns Updated targeting configuration
      */
     updateFirstPartyAudiences(accountId: string, campaignId: string, targeting: UpdateFirstPartyAudienceTargetingRequest): Promise<FirstPartyAudienceTargeting>;
     /**
      * Get marking labels (pixel retargeting) targeting for a campaign
-     *
-     * Marking labels allow you to target users based on pixel-tracked
-     * behavior using custom labels.
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @returns Marking labels targeting configuration
-     *
-     * @example
-     * ```typescript
-     * const targeting = await client.targeting.getMarkingLabels('my-account', '12345');
-     * console.log('Labels:', targeting.collection);
-     * ```
      */
     getMarkingLabels(accountId: string, campaignId: string): Promise<MarkingLabelsTargeting>;
     /**
      * Update marking labels targeting for a campaign
-     *
-     * @param accountId - Account ID
-     * @param campaignId - Campaign ID
-     * @param targeting - Marking labels targeting configuration
-     * @returns Updated targeting configuration
-     *
-     * @example
-     * ```typescript
-     * await client.targeting.updateMarkingLabels('my-account', '12345', {
-     *   type: 'EXISTS',
-     *   collection: ['label-1', 'label-2'],
-     * });
-     * ```
      */
     updateMarkingLabels(accountId: string, campaignId: string, targeting: UpdateMarkingLabelsTargetingRequest): Promise<MarkingLabelsTargeting>;
 }
@@ -3100,82 +2990,22 @@ declare class CombinedAudiencesAPI {
     constructor(http: HttpClient);
     /**
      * List available audiences for combining
-     *
-     * Returns all audiences that can be used in combined audience rules,
-     * including custom, lookalike, marketplace, and first-party audiences.
-     *
-     * @param accountId - Account ID
-     * @returns List of available audiences
-     *
-     * @example
-     * ```typescript
-     * const available = await client.combinedAudiences.listAvailable('my-account');
-     * console.log(`${available.length} audiences available for combining`);
-     * ```
      */
     listAvailable(accountId: string): Promise<AvailableAudience[]>;
     /**
      * List all combined audiences
-     *
-     * @param accountId - Account ID
-     * @returns List of combined audiences
-     *
-     * @example
-     * ```typescript
-     * const audiences = await client.combinedAudiences.list('my-account');
-     * for (const audience of audiences) {
-     *   console.log(`${audience.name}: ${audience.status}`);
-     * }
-     * ```
      */
     list(accountId: string): Promise<CombinedAudience[]>;
     /**
      * Get a single combined audience
-     *
-     * @param accountId - Account ID
-     * @param audienceId - Combined audience ID
-     * @returns Combined audience details
      */
     get(accountId: string, audienceId: string): Promise<CombinedAudience>;
     /**
      * Create a combined audience
-     *
-     * @param accountId - Account ID
-     * @param audience - Combined audience configuration
-     * @returns Created combined audience
-     *
-     * @example
-     * ```typescript
-     * const audience = await client.combinedAudiences.create('my-account', {
-     *   name: 'High-Value Engaged Users',
-     *   description: 'Users who are both high-value and engaged',
-     *   include_rules: [
-     *     {
-     *       audience_type: 'CUSTOM_AUDIENCE',
-     *       audiences: [{ id: 'custom-1', name: null }]
-     *     },
-     *     {
-     *       audience_type: 'LOOKALIKE_AUDIENCE',
-     *       audiences: [{ id: 'lookalike-1', name: null }]
-     *     }
-     *   ],
-     *   exclude_rules: [
-     *     {
-     *       audience_type: 'CUSTOM_AUDIENCE',
-     *       audiences: [{ id: 'converters', name: null }]
-     *     }
-     *   ]
-     * });
-     * ```
      */
     create(accountId: string, audience: CreateCombinedAudienceRequest): Promise<CombinedAudience>;
     /**
      * Update a combined audience
-     *
-     * @param accountId - Account ID
-     * @param audienceId - Combined audience ID
-     * @param updates - Fields to update
-     * @returns Updated combined audience
      */
     update(accountId: string, audienceId: string, updates: UpdateCombinedAudienceRequest): Promise<CombinedAudience>;
 }
@@ -3195,98 +3025,20 @@ declare class FirstPartyAudiencesAPI {
     constructor(http: HttpClient);
     /**
      * List all first party audiences
-     *
-     * @param accountId - Account ID
-     * @returns List of first party audiences
-     *
-     * @example
-     * ```typescript
-     * const audiences = await client.firstPartyAudiences.list('my-account');
-     * for (const audience of audiences) {
-     *   console.log(`${audience.name}: ${audience.status} (${audience.size} users)`);
-     * }
-     * ```
      */
     list(accountId: string): Promise<FirstPartyAudience[]>;
     /**
      * Get a single first party audience
-     *
-     * @param accountId - Account ID
-     * @param audienceId - Audience ID
-     * @returns First party audience details
      */
     get(accountId: string, audienceId: string): Promise<FirstPartyAudience>;
     /**
      * Create a first party audience
-     *
-     * After creation, use addUsers() to populate the audience with identifiers.
-     *
-     * @param accountId - Account ID
-     * @param audience - Audience configuration
-     * @returns Created audience
-     *
-     * @example
-     * ```typescript
-     * const audience = await client.firstPartyAudiences.create('my-account', {
-     *   name: 'High-Value Customers',
-     *   description: 'Customers with LTV > $1000',
-     *   source_type: 'CRM',
-     *   ttl_days: 90
-     * });
-     *
-     * // Then add users
-     * await client.firstPartyAudiences.addUsers('my-account', audience.id, {
-     *   add: [
-     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash1' },
-     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash2' },
-     *   ]
-     * });
-     * ```
      */
     create(accountId: string, audience: CreateFirstPartyAudienceRequest): Promise<FirstPartyAudience>;
     /**
      * Add or remove users from a first party audience
-     *
-     * Users are identified by hashed identifiers (email, phone, device ID).
-     * It's recommended to use SHA256 hashed values for privacy.
-     *
-     * @param accountId - Account ID
-     * @param audienceId - Audience ID
-     * @param request - Add/remove request with user identifiers
-     * @returns Operation result with counts
-     *
-     * @example
-     * ```typescript
-     * // Add users
-     * const result = await client.firstPartyAudiences.addUsers('my-account', 'audience-1', {
-     *   add: [
-     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash1' },
-     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash2' },
-     *   ]
-     * });
-     * console.log(`Added ${result.added_count} users`);
-     *
-     * // Remove users
-     * const result2 = await client.firstPartyAudiences.addUsers('my-account', 'audience-1', {
-     *   remove: [
-     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash3' },
-     *   ]
-     * });
-     * console.log(`Removed ${result2.removed_count} users`);
-     * ```
      */
-    addUsers(accountId: string, audienceId: string, request: AddRemoveUsersRequest): Promise<AddRemoveUsersResponse>;
-    /**
-     * Remove users from a first party audience
-     *
-     * Convenience method that wraps addUsers with only remove operations.
-     *
-     * @param accountId - Account ID
-     * @param audienceId - Audience ID
-     * @param request - Remove request with user identifiers
-     * @returns Operation result with counts
-     */
-    removeUsers(accountId: string, audienceId: string, request: Pick<AddRemoveUsersRequest, 'remove'>): Promise<AddRemoveUsersResponse>;
+    manageUsers(accountId: string, request: AudienceUsersRequest): Promise<void>;
 }
 
 /**
@@ -3325,7 +3077,7 @@ declare class PixelAPI {
      * @param ruleId - Conversion rule ID
      * @returns Conversion rule details
      */
-    getConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    getConversionRule(accountId: string, ruleId: number): Promise<ConversionRule>;
     /**
      * List conversion rules with performance data
      *
@@ -3348,23 +3100,17 @@ declare class PixelAPI {
      * // URL-based conversion rule
      * const rule = await client.pixel.createConversionRule('my-account', {
      *   display_name: 'Purchase Completed',
-     *   type: 'URL_BASED',
-     *   category: 'PURCHASE',
-     *   conditions: [
-     *     {
-     *       type: 'URL',
-     *       operator: 'CONTAINS',
-     *       value: '/thank-you'
-     *     }
-     *   ],
-     *   effect: {
-     *     type: 'DYNAMIC_VALUE',
-     *     value: null,
-     *     currency: 'USD',
-     *     value_parameter: 'order_total'
+     *   type: 'BASIC',
+     *   category: 'MAKE_PURCHASE',
+     *   condition: {
+     *     property: 'URL',
+     *     predicate: 'CONTAINS',
+     *     value: '/thank-you',
+     *     children: [],
      *   },
-     *   conversion_window_days: 30,
-     *   view_through_window_days: 1
+     *   effects: [{ type: 'REVENUE', data: '15' }],
+     *   look_back_window: 30,
+     *   view_through_look_back_window: 1,
      * });
      *
      * // Event-based conversion rule
@@ -3373,13 +3119,7 @@ declare class PixelAPI {
      *   type: 'EVENT_BASED',
      *   category: 'ADD_TO_CART',
      *   event_name: 'add_to_cart',
-     *   conditions: [],
-     *   effect: {
-     *     type: 'FIXED_VALUE',
-     *     value: 10,
-     *     currency: 'USD',
-     *     value_parameter: null
-     *   }
+     *   effects: [{ type: 'REVENUE', data: '10' }],
      * });
      * ```
      */
@@ -3392,7 +3132,7 @@ declare class PixelAPI {
      * @param updates - Fields to update
      * @returns Updated conversion rule
      */
-    updateConversionRule(accountId: string, ruleId: string, updates: UpdateConversionRuleRequest): Promise<ConversionRule>;
+    updateConversionRule(accountId: string, ruleId: number, updates: UpdateConversionRuleRequest): Promise<ConversionRule>;
     /**
      * Archive a conversion rule
      *
@@ -3403,7 +3143,7 @@ declare class PixelAPI {
      * @param ruleId - Conversion rule ID
      * @returns Archived conversion rule
      */
-    archiveConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    archiveConversionRule(accountId: string, ruleId: number): Promise<ConversionRule>;
     /**
      * Unarchive a conversion rule
      *
@@ -3413,7 +3153,7 @@ declare class PixelAPI {
      * @param ruleId - Conversion rule ID
      * @returns Reactivated conversion rule
      */
-    unarchiveConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    unarchiveConversionRule(accountId: string, ruleId: number): Promise<ConversionRule>;
     /**
      * List all custom audience rules
      *
@@ -3449,37 +3189,16 @@ declare class PixelAPI {
      *
      * @example
      * ```typescript
-     * // All visitors audience
      * const allVisitors = await client.pixel.createCustomAudienceRule('my-account', {
      *   display_name: 'All Visitors - 30 Days',
      *   conditions: [],
-     *   ttl_days: 30
+     *   ttl_days: 30,
      * });
      *
-     * // Product page visitors
      * const productViewers = await client.pixel.createCustomAudienceRule('my-account', {
      *   display_name: 'Product Page Viewers',
-     *   conditions: [
-     *     {
-     *       type: 'URL',
-     *       operator: 'CONTAINS',
-     *       value: '/products/'
-     *     }
-     *   ],
-     *   ttl_days: 14
-     * });
-     *
-     * // Cart abandoners
-     * const cartAbandoners = await client.pixel.createCustomAudienceRule('my-account', {
-     *   display_name: 'Cart Abandoners',
-     *   conditions: [
-     *     {
-     *       type: 'EVENT_NAME',
-     *       operator: 'EQUALS',
-     *       value: 'add_to_cart'
-     *     }
-     *   ],
-     *   ttl_days: 7
+     *   conditions: [{ type: 'URL', operator: 'CONTAINS', value: '/products/' }],
+     *   ttl_days: 14,
      * });
      * ```
      */
@@ -3981,4 +3700,4 @@ declare class TaboolaServerError extends TaboolaError {
  */
 declare function parseApiError(statusCode: number, response: unknown, url: string): TaboolaError;
 
-export { type Account, type AccountType, AccountsAPI, type ActivitySchedule, type ActivityScheduleRule, type AddRemoveUsersRequest, type AddRemoveUsersResponse, type AdvertiserAccount, type AllowedAccountsResponse, type ApprovalState, type AudienceSegment, type AudienceTargeting, type AvailableAudience, type AvailableAudiencesResponse, type BidStrategy, type BlockedPublisher, type BlockedPublishersResponse, type BrandSafetyProvider, type Browser, type BulkCampaignUpdate, type BulkCampaignUpdateRequest, type BulkCreateItemsRequest, type BulkCreateItemsResponse, type BulkDeleteItemsRequest, type BulkUpdateItemsRequest, type CTA, type CTAType, type Campaign, type CampaignBase, type CampaignBaseListResponse, type CampaignEnums, type CampaignItem, type CampaignItemListResponse, type CampaignListResponse, type CampaignPatchRequest, type CampaignReachEstimatorRequest, type CampaignReachEstimatorResponse, type CampaignStatus, type CampaignSummaryReport, type CampaignSummaryReportParams, type CampaignSummaryRow, type CampaignTargetingCollection, type CampaignType, CampaignsAPI, type CombinedAudience, type CombinedAudienceListResponse, type CombinedAudienceRule, CombinedAudiencesAPI, type Condition, type ConditionOperator, type ConditionType, type ConnectionType, type ContextualSegment, type ContextualSegmentValue, type ContextualTargeting, type ConversionRule, type ConversionRuleListResponse, type ConversionRuleStatus, type ConversionRuleType, type ConversionRuleWithData, type ConversionRuleWithDataListResponse, type Coordinates, type Country, type CreateCampaignRequest, type CreateCombinedAudienceRequest, type CreateConversionRuleRequest, type CreateCustomAudienceRuleRequest, type CreateFirstPartyAudienceRequest, type CreateItemRequest, type CreateSharedBudgetRequest, type CreativeFocus, type CreativeFocusType, type CurrencyCode, type CustomAudienceRule, type CustomAudienceRuleListResponse, type CustomAudienceRuleStatus, DEFAULT_BASE_URL, type DMA, type DailyAdDeliveryModel, type DateString, type DayOfWeek, DictionaryAPI, type Effect, type EffectType, type ExternalBrandSafety, type FirstPartyAudience, type FirstPartyAudienceTargeting, type FirstPartyAudienceUser, FirstPartyAudiencesAPI, HttpClient, type HttpClientOptions, type ImageLibraryItem, type ImageLibrarySearchParams, type ImageLibrarySearchResponse, type ImageUploadResponse, type ItemEnums, type ItemPolicyReview, type ItemStatus, type ItemType, type ItemVerificationPixel, type ItemViewabilityTag, ItemsAPI, type ListCampaignsOptions, type ListItemsOptions, type ListResponse, type LookalikeAudience, type MarketingObjective, type MarketplaceAudience, type MarkingLabelsTargeting, type MinimumCPC, type MultiTargeting, type MultiTargetingState, type NetworkAdvertisersResponse, OAuthManager, type OSVersion, type OperatingSystem, type OperatingSystemInfo, type PaginationParams, type PartnerType, type PatchOperation, PixelAPI, type Platform, type PlatformType, type PolicyReview, type PostalCode, type PostalCodeTargeting, type PostalCodeValue, type PricingModel, type Publisher, type PublisherBidModifier, type PublisherBidModifierCollection, type PublisherBidStrategyModifier, type PublisherBidStrategyModifierCollection, type PublisherListResponse, PublishersAPI, type RSSChildItem, type RSSChildrenListResponse, type RealtimeAdsDimension, type RealtimeAdsReport, type RealtimeAdsReportParams, type RealtimeAdsRow, type RealtimeCampaignDimension, type RealtimeCampaignReport, type RealtimeCampaignReportParams, type RealtimeCampaignRow, type Region, type ReportDimension, type ReportMetadata, ReportsAPI, type SharedBudget, SharedBudgetAPI, type SharedBudgetBase, type SharedBudgetBaseListResponse, type SharedBudgetCampaign, type SharedBudgetCampaignAttribute, type SpendingLimitModel, type StoredToken, TaboolaAuthError, TaboolaClient, type TaboolaConfig, TaboolaError, TaboolaForbiddenError, TaboolaNotFoundError, TaboolaRateLimitError, TaboolaServerError, TaboolaValidationError, TargetingAPI, type TargetingType, type TargetingValue, type TokenResponse, type TopCampaignContentReport, type TopCampaignContentReportParams, type TopCampaignContentRow, type TrafficAllocationMode, type UpdateAudienceTargetingRequest, type UpdateBlockedPublishersRequest, type UpdateCampaignRequest, type UpdateCombinedAudienceRequest, type UpdateContextualTargetingRequest, type UpdateConversionRuleRequest, type UpdateCustomAudienceRuleRequest, type UpdateFirstPartyAudienceTargetingRequest, type UpdateItemRequest, type UpdateMarkingLabelsTargetingRequest, type UpdatePostalCodeTargetingRequest, type UpdateSharedBudgetRequest, type VerificationPixel, type ViewabilityTag, createClient, parseApiError };
+export { type Account, type AccountType, AccountsAPI, type ActivitySchedule, type ActivityScheduleRule, type AdvertiserAccount, type AllowedAccountsResponse, type ApprovalState, type AudienceTargeting, type AudienceUserClusterItem, type AudienceUserIdentity, type AudienceUsersRequest, type AvailableAudience, type AvailableAudiencesResponse, type BidStrategy, type BlockedPublishersResponse, type BrandSafetyProvider, type Browser, type BulkCampaignUpdateRequest, type BulkCreateItemsRequest, type BulkCreateItemsResponse, type BulkDeleteItemsRequest, type BulkUpdateItemsRequest, type CTA, type CTAType, type Campaign, type CampaignBase, type CampaignBaseListResponse, type CampaignEnums, type CampaignItem, type CampaignItemListResponse, type CampaignListResponse, type CampaignPatchRequest, type CampaignReachEstimatorRequest, type CampaignReachEstimatorResponse, type CampaignStatus, type CampaignSummaryReport, type CampaignSummaryReportParams, type CampaignSummaryRow, type CampaignTargetingCollection, type CampaignType, CampaignsAPI, type CombinedAudience, type CombinedAudienceListResponse, type CombinedAudienceRule, CombinedAudiencesAPI, type ConnectionType, type ContextualSegment, type ContextualTargeting, type ConversionCategory, type ConversionCondition, type ConversionConditionPredicate, type ConversionEffect, type ConversionRule, type ConversionRuleListResponse, type ConversionRuleStatus, type ConversionRuleType, type ConversionRuleWithData, type ConversionRuleWithDataListResponse, type Coordinates, type Country, type CreateCampaignRequest, type CreateCombinedAudienceRequest, type CreateConversionRuleRequest, type CreateCustomAudienceRuleRequest, type CreateFirstPartyAudienceRequest, type CreateItemRequest, type CreateSharedBudgetRequest, type CreativeFocus, type CreativeFocusType, type CurrencyCode, type CustomAudienceCondition, type CustomAudienceConditionOperator, type CustomAudienceConditionType, type CustomAudienceRule, type CustomAudienceRuleListResponse, type CustomAudienceRuleStatus, DEFAULT_BASE_URL, type DMA, type DailyAdDeliveryModel, type DateString, type DayOfWeek, DictionaryAPI, type DuplicateCampaignRequest, type DuplicateSettings, type ExternalBrandSafety, type FirstPartyAudience, type FirstPartyAudienceTargeting, FirstPartyAudiencesAPI, HttpClient, type HttpClientOptions, type ImageLibraryItem, type ImageLibrarySearchParams, type ImageLibrarySearchResponse, type ImageUploadResponse, type ItemEnums, type ItemPolicyReview, type ItemStatus, type ItemType, type ItemVerificationPixel, type ItemViewabilityTag, ItemsAPI, type ListCampaignsOptions, type ListItemsOptions, type ListResponse, type LookalikeAudience, type LookalikeAudienceItem, type LookalikeAudienceTargeting, type MarketingObjective, type MarketplaceAudience, type MarkingLabelsTargeting, type MinimumCPC, type MultiTargeting, type MultiTargetingState, type NetworkAdvertisersResponse, OAuthManager, type OSVersion, type OperatingSystem, type OperatingSystemInfo, type PaginationParams, type PartnerType, type PatchOperation, PixelAPI, type Platform, type PlatformType, type PolicyReview, type PostalCode, type PostalCodeTargeting, type PricingModel, type Publisher, type PublisherBidModifier, type PublisherBidModifierCollection, type PublisherBidStrategyModifier, type PublisherBidStrategyModifierCollection, type PublisherListResponse, PublishersAPI, type RSSChildItem, type RSSChildrenListResponse, type RealtimeAdsDimension, type RealtimeAdsReport, type RealtimeAdsReportParams, type RealtimeAdsRow, type RealtimeCampaignDimension, type RealtimeCampaignReport, type RealtimeCampaignReportParams, type RealtimeCampaignRow, type Region, type ReportDimension, type ReportMetadata, ReportsAPI, type SharedBudget, SharedBudgetAPI, type SharedBudgetBase, type SharedBudgetBaseListResponse, type SharedBudgetCampaign, type SharedBudgetCampaignAttribute, type SpendingLimitModel, type StoredToken, TaboolaAuthError, TaboolaClient, type TaboolaConfig, TaboolaError, TaboolaForbiddenError, TaboolaNotFoundError, TaboolaRateLimitError, TaboolaServerError, TaboolaValidationError, TargetingAPI, type TargetingRestriction, type TargetingType, type TargetingValue, type TokenResponse, type TopCampaignContentReport, type TopCampaignContentReportParams, type TopCampaignContentRow, type TrafficAllocationMode, type UpdateAudienceTargetingRequest, type UpdateBlockedPublishersRequest, type UpdateCampaignRequest, type UpdateCombinedAudienceRequest, type UpdateContextualTargetingRequest, type UpdateConversionRuleRequest, type UpdateCustomAudienceRuleRequest, type UpdateFirstPartyAudienceTargetingRequest, type UpdateItemRequest, type UpdateLookalikeAudienceTargetingRequest, type UpdateMarkingLabelsTargetingRequest, type UpdatePostalCodeTargetingRequest, type UpdateSharedBudgetRequest, type VerificationPixel, type ViewabilityTag, createClient, parseApiError };