@getlatedev/node 0.2.1179 → 0.2.1181

package/dist/index.d.mts

@@ -2572,7 +2572,7 @@ type AdCampaign = {
      */
     statusReadAt?: (string) | null;
     /**
-     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
      */
     nativeSettings?: {
         [key: string]: unknown;
@@ -2616,6 +2616,10 @@ type AdCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
      */
@@ -3381,6 +3385,10 @@ type AdTreeAdSet = {
      */
     createdTime?: (string) | null;
     adCount?: number;
+    /**
+     * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
      */
@@ -3535,6 +3543,10 @@ type AdTreeCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
      */
@@ -6326,8 +6338,9 @@ type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -6340,6 +6353,16 @@ type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -41757,7 +41780,7 @@ type ListAdSetsResponse = ({
             [key: string]: unknown;
         } | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -44851,6 +44874,10 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -47908,9 +47935,9 @@ type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -47944,6 +47971,16 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */

package/dist/index.d.ts

@@ -2572,7 +2572,7 @@ type AdCampaign = {
      */
     statusReadAt?: (string) | null;
     /**
-     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
      */
     nativeSettings?: {
         [key: string]: unknown;
@@ -2616,6 +2616,10 @@ type AdCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
      */
@@ -3381,6 +3385,10 @@ type AdTreeAdSet = {
      */
     createdTime?: (string) | null;
     adCount?: number;
+    /**
+     * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
      */
@@ -3535,6 +3543,10 @@ type AdTreeCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
      */
@@ -6326,8 +6338,9 @@ type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -6340,6 +6353,16 @@ type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -41757,7 +41780,7 @@ type ListAdSetsResponse = ({
             [key: string]: unknown;
         } | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -44851,6 +44874,10 @@ type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -47908,9 +47935,9 @@ type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -47944,6 +47971,16 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1179",
+  version: "0.2.1181",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1179",
+  version: "0.2.1181",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1179",
+  "version": "0.2.1181",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -10346,8 +10346,8 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
  * The rolled-up `status` is not re-derived by a live read. On TikTok the same live read also
  * returns the ad group's applied `optimizationGoal` and `billingEvent`, as TikTok's adgroup/get
  * reports them, so you can verify the goal TikTok applied rather than the one you requested.
- * It also returns `nativeSettings`: TikTok's own adgroup/get record for the ad group, verbatim and
- * read in that same call (budget, budget_mode, schedule, placements, locations, ages, gender,
+ * It also returns `nativeSettings`: a fixed subset of TikTok's own adgroup/get record for the ad group, with
+ * TikTok's own values, read in that same call (budget, budget_mode, schedule, placements, locations, ages, gender,
  * languages, interests, actions, audiences and exclusions), plus the advertiser's currency and
  * timezone. TikTok's `schedule_start_time` / `schedule_end_time` are UTC wall clocks
  * ("YYYY-MM-DD HH:MM:SS", no offset); Ads Manager displays them in `advertiser_timezone`. `configReadAt` says when it was read; it

package/src/generated/types.gen.ts

@@ -577,7 +577,7 @@ export type AdCampaign = {
      */
     statusReadAt?: (string) | null;
     /**
-     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. TikTok's campaign/get record verbatim: operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info.
+     * TikTok only, only on GET /v1/ads/campaigns with `live=true` and only on campaigns read live. A fixed subset of TikTok's campaign/get record, not the whole record: campaign_id, operation_status, objective_type, budget_mode (BUDGET_MODE_INFINITE means no campaign budget, so budget lives on the ad groups), budget, and budget_optimize_on, each with TikTok's own value and present only when TikTok returns it. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. Whether the campaign is Upgraded Smart+ is `isSmartPlus`.
      */
     nativeSettings?: {
         [key: string]: unknown;
@@ -621,6 +621,10 @@ export type AdCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type. See AdTreeCampaign.advertisingChannelType.
      */
@@ -1413,6 +1417,10 @@ export type AdTreeAdSet = {
      */
     createdTime?: (string) | null;
     adCount?: number;
+    /**
+     * TikTok only. true when this ad group belongs to an Upgraded Smart+ campaign. See AdTreeCampaign.isSmartPlus.
+     */
+    isSmartPlus?: boolean;
     /**
      * Effective budget at this level (back-compat). For CBO campaigns this mirrors the parent campaign's budget; for ABO this is the ad-set-specific budget. Use `adSetBudget` / parent `campaignBudget` + `budgetLevel` to disambiguate.
      */
@@ -1568,6 +1576,10 @@ export type AdTreeCampaign = {
     platformAdAccountName?: (string) | null;
     accountId?: string;
     profileId?: string;
+    /**
+     * TikTok only. true when the campaign is an Upgraded Smart+ campaign (TikTok lists it on /smart_plus/campaign/get/), false when it is not. Set by ads sync, so the key is absent on other platforms and on TikTok campaigns not synced since this field shipped. On Smart+ objects Zernio can pause, resume, rename, delete and change the budget of the campaign and ad set, and pause or resume an ad; other edits answer 422 and belong in TikTok Ads Manager.
+     */
+    isSmartPlus?: boolean;
     /**
      * Google-only. Raw campaign.advertising_channel_type (SEARCH, PERFORMANCE_MAX, LOCAL_SERVICES, VIDEO, DEMAND_GEN, DISPLAY, SHOPPING, ...). Serving surface, distinct from platformObjective (advertiser intent). Null/absent for non-Google platforms.
      */
@@ -4505,8 +4517,9 @@ export type CtwaAdRequestBody = {
     /**
      * Messaging and CTWA only (a 400 on POST /v1/ads/call). A hand-built carousel
      * of 2-10 image cards, sent to Meta in the order given as
-     * `link_data.child_attachments` (Meta may reorder them for performance, since
-     * `multi_share_optimized` defaults to true and no field fixes the order today); every
+     * `link_data.child_attachments` (by default Meta may reorder them for performance,
+     * since `multi_share_optimized` defaults to true; `optimizeCardOrder: false` keeps
+     * the order given); every
      * card (and the carousel itself) carries the destination's messaging call to
      * action (WHATSAPP_MESSAGE, MESSAGE_PAGE or INSTAGRAM_MESSAGE), so a tap on any
      * card opens the conversation. Replaces `imageUrl` / `video` (sending either is
@@ -4519,6 +4532,16 @@ export type CtwaAdRequestBody = {
      *
      */
     carouselCards?: Array<MessagingCarouselCard>;
+    /**
+     * Only with `carouselCards` (a 400 without them). Sets the creative's
+     * `link_data.multi_share_optimized`. `false` keeps the cards in the order given;
+     * Meta then takes at most 5 cards, so `false` with more than 5 `carouselCards` is a
+     * 400. `true` lets Meta pick and reorder the cards for performance (up to 10).
+     * Omitted, nothing is sent and Meta's default (`true`) applies. Single-creative
+     * shape; for `creatives[]` set it per entry.
+     *
+     */
+    optimizeCardOrder?: boolean;
     /**
      * Multi-creative shape: N CTWA ads under one campaign + one
      * ad set, sharing budget and targeting. Mutually exclusive
@@ -42225,7 +42248,7 @@ export type ListAdSetsResponse = ({
             [key: string]: unknown;
         } | null;
         /**
-         * TikTok only, only with `live=true` and only on rows read live. TikTok's adgroup/get record verbatim (snake_case, TikTok's own names and enums): operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
+         * TikTok only, only with `live=true` and only on rows read live. A fixed subset of TikTok's adgroup/get record, not the whole record (snake_case, TikTok's own names, enums and values): adgroup_id, campaign_id, operation_status, optimization_goal, optimization_event, billing_event, bid_type, bid_price, budget, budget_mode, pacing, schedule_type, schedule_start_time, schedule_end_time, dayparting, placement_type, placements, location_ids, age_groups, gender, languages, interest_category_ids, interest_keyword_ids, actions, audience_ids, excluded_audience_ids, operating_systems, frequency, frequency_schedule, smart_audience_enabled, smart_interest_behavior_enabled. schedule_start_time and schedule_end_time are UTC wall clocks (YYYY-MM-DD HH:MM:SS). location_ids holds TikTok's native location ids (GeoNames ids for countries); GET /v1/ads/targeting/search?dimension=geo returns them as `platformId` on country results. Plus advertiser_currency and advertiser_timezone from TikTok's advertiser/info. A field TikTok does not return is absent.
          */
         nativeSettings?: {
             [key: string]: unknown;
@@ -45516,6 +45539,10 @@ export type CreateAdCreativeData = {
             description?: string;
             callToAction?: string;
         }>;
+        /**
+         * Only with `carouselCards` (a 400 without them). Sets `link_data.multi_share_optimized`: `false` keeps the cards in the order given, and Meta then takes at most 5 cards, so `false` with more than 5 cards is a 400; `true` lets Meta reorder them for performance. Omitted, nothing is sent and Meta's default (`true`) applies.
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Appended to every outbound URL (e.g. utm_source=fb).
          */
@@ -48723,9 +48750,9 @@ export type CreateStandaloneAdData = {
          *
          * Meta only. Hand-built carousel: 2-10 authored cards, sent in the order given as
          * the creative's `link_data.child_attachments`. Unlike `dynamicCreative`,
-         * you author every card's copy and link, but Meta may still reorder the cards
-         * for performance (`multi_share_optimized` defaults to true and Zernio does not
-         * send it), and no field fixes the order today. Requires top-level `body`
+         * you author every card's copy and link, but by default Meta may still reorder the
+         * cards for performance (`multi_share_optimized` defaults to true); send
+         * `optimizeCardOrder: false` to keep the order given. Requires top-level `body`
          * and `callToAction`; `linkUrl` is also required UNLESS `leadGenFormId` is set. Those
          * become the ad's own Destination and button (`link_data.link` / `link_data.call_to_action`),
          * and double as the per-card fallback when a card omits its own.
@@ -48759,6 +48786,16 @@ export type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * Meta only (a 400 on any other platform), and only with `carouselCards` (a 400
+         * without them). Sets the creative's `link_data.multi_share_optimized`. `false`
+         * keeps the cards in the order given; Meta then takes at most 5 cards, so `false`
+         * with more than 5 `carouselCards` is a 400. `true` lets Meta pick and reorder the
+         * cards for performance (up to 10). Omitted, nothing is sent and Meta's default
+         * (`true`) applies.
+         *
+         */
+        optimizeCardOrder?: boolean;
         /**
          * Meta only. Language the top-level copy is written in (e.g. `en`, `pt_BR`), used by the `translations` default rule. Defaults to `en`. Meta rejects a language asset feed whose default rule carries no locales of its own. Must NOT also appear as an entry in `translations`.
          */