@zernio/node 0.2.470 → 0.2.472

package/dist/index.d.mts

@@ -1625,7 +1625,7 @@ type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -5480,7 +5480,7 @@ type TargetingSpec = {
     ageMin?: number;
     ageMax?: number;
     /**
-     * Restrict by gender. 'all' (default) targets everyone.
+     * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
      */
     gender?: 'all' | 'male' | 'female';
     /**
@@ -5536,7 +5536,7 @@ type TargetingSpec = {
     audienceExclude?: Array<(string)>;
 };
 /**
- * Restrict by gender. 'all' (default) targets everyone.
+ * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
  */
 type gender = 'all' | 'male' | 'female';
 /**
@@ -24690,6 +24690,24 @@ type CreateAdCampaignData = {
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         */
+        bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
+        /**
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         */
+        bidAmount?: number;
+        /**
+         * Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+    };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
     };
 };
 type CreateAdCampaignResponse = ({
@@ -24860,6 +24878,12 @@ type DuplicateAdCampaignData = {
          */
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform campaign ID
@@ -24905,6 +24929,12 @@ type DuplicateAdSetData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform ad set ID
@@ -24940,6 +24970,12 @@ type DuplicateAdData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Zernio ad ID or platform ad ID
@@ -25234,7 +25270,7 @@ type GetAdsTimelineResponse = ({
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         costPerConversion?: number;
@@ -26746,7 +26782,7 @@ type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             /**
-             * Meta only.
+             * Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
              */
             gender?: 'all' | 'male' | 'female';
             /**
@@ -27086,9 +27122,13 @@ type CreateStandaloneAdData = {
          */
         video?: {
             /**
-             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s. Provide either `url` or `id`.
              */
-            url: string;
+            url?: string;
+            /**
+             * Meta only. Reuse a video ALREADY uploaded to this ad account instead of re-uploading the file: pass the `videoId` returned by a previous create. Wins over `url`, so N ads that differ only in copy share one upload (`existingCreativeId` only covers the identical-copy case). Provide either `url` or `id`.
+             */
+            id?: string;
             /**
              * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
@@ -27445,6 +27485,54 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * 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.
+         */
+        defaultLocale?: string;
+        /**
+         * Meta only. Multi-language ads (Dynamic Language Optimization): ONE ad carrying
+         * per-locale copy and, optionally, per-locale media — the "Languages" toggle in Ads
+         * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
+         * splitting it across one ad per language.
+         *
+         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
+         * to, and a variant inherits any field it omits, so send only what differs per
+         * language. Media shared across languages is uploaded once.
+         *
+         * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
+         * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
+         *
+         */
+        translations?: Array<{
+            /**
+             * Language code, resolved to Meta's numeric locale id. Bare codes target the '(All)' umbrella (`es` = every Spanish variant); region-qualified codes target the variant (`pt_BR`, `en_GB`).
+             */
+            locale: string;
+            /**
+             * Headline for this language. Inherits the top-level `headline` when omitted.
+             */
+            headline?: string;
+            /**
+             * Primary text for this language. Inherits the top-level `body` when omitted.
+             */
+            body?: string;
+            /**
+             * Link description for this language. Inherits the top-level `description` when omitted.
+             */
+            description?: string;
+            /**
+             * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
+             */
+            imageUrl?: string;
+            /**
+             * Video for this language. Inherits the ad's `video.url` when omitted. The feed is all-image OR all-video.
+             */
+            videoUrl?: string;
+            /**
+             * Poster frame for this language's video.
+             */
+            thumbnailUrl?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
@@ -27555,7 +27643,7 @@ type CreateStandaloneAdData = {
             windowDays: 1 | 7 | 28;
         }>;
         /**
-         * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
+         * Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
          */
         gender?: 'all' | 'male' | 'female';
         /**

package/dist/index.d.ts

@@ -1625,7 +1625,7 @@ type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -5480,7 +5480,7 @@ type TargetingSpec = {
     ageMin?: number;
     ageMax?: number;
     /**
-     * Restrict by gender. 'all' (default) targets everyone.
+     * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
      */
     gender?: 'all' | 'male' | 'female';
     /**
@@ -5536,7 +5536,7 @@ type TargetingSpec = {
     audienceExclude?: Array<(string)>;
 };
 /**
- * Restrict by gender. 'all' (default) targets everyone.
+ * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
  */
 type gender = 'all' | 'male' | 'female';
 /**
@@ -24690,6 +24690,24 @@ type CreateAdCampaignData = {
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         */
+        bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
+        /**
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         */
+        bidAmount?: number;
+        /**
+         * Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+    };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
     };
 };
 type CreateAdCampaignResponse = ({
@@ -24860,6 +24878,12 @@ type DuplicateAdCampaignData = {
          */
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform campaign ID
@@ -24905,6 +24929,12 @@ type DuplicateAdSetData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform ad set ID
@@ -24940,6 +24970,12 @@ type DuplicateAdData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Zernio ad ID or platform ad ID
@@ -25234,7 +25270,7 @@ type GetAdsTimelineResponse = ({
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         costPerConversion?: number;
@@ -26746,7 +26782,7 @@ type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             /**
-             * Meta only.
+             * Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
              */
             gender?: 'all' | 'male' | 'female';
             /**
@@ -27086,9 +27122,13 @@ type CreateStandaloneAdData = {
          */
         video?: {
             /**
-             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s. Provide either `url` or `id`.
              */
-            url: string;
+            url?: string;
+            /**
+             * Meta only. Reuse a video ALREADY uploaded to this ad account instead of re-uploading the file: pass the `videoId` returned by a previous create. Wins over `url`, so N ads that differ only in copy share one upload (`existingCreativeId` only covers the identical-copy case). Provide either `url` or `id`.
+             */
+            id?: string;
             /**
              * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
@@ -27445,6 +27485,54 @@ type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * 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.
+         */
+        defaultLocale?: string;
+        /**
+         * Meta only. Multi-language ads (Dynamic Language Optimization): ONE ad carrying
+         * per-locale copy and, optionally, per-locale media — the "Languages" toggle in Ads
+         * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
+         * splitting it across one ad per language.
+         *
+         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
+         * to, and a variant inherits any field it omits, so send only what differs per
+         * language. Media shared across languages is uploaded once.
+         *
+         * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
+         * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
+         *
+         */
+        translations?: Array<{
+            /**
+             * Language code, resolved to Meta's numeric locale id. Bare codes target the '(All)' umbrella (`es` = every Spanish variant); region-qualified codes target the variant (`pt_BR`, `en_GB`).
+             */
+            locale: string;
+            /**
+             * Headline for this language. Inherits the top-level `headline` when omitted.
+             */
+            headline?: string;
+            /**
+             * Primary text for this language. Inherits the top-level `body` when omitted.
+             */
+            body?: string;
+            /**
+             * Link description for this language. Inherits the top-level `description` when omitted.
+             */
+            description?: string;
+            /**
+             * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
+             */
+            imageUrl?: string;
+            /**
+             * Video for this language. Inherits the ad's `video.url` when omitted. The feed is all-image OR all-video.
+             */
+            videoUrl?: string;
+            /**
+             * Poster frame for this language's video.
+             */
+            thumbnailUrl?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
@@ -27555,7 +27643,7 @@ type CreateStandaloneAdData = {
             windowDays: 1 | 7 | 28;
         }>;
         /**
-         * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
+         * Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
          */
         gender?: 'all' | 'male' | 'female';
         /**

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.470",
+  version: "0.2.472",
   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: "@zernio/node",
-  version: "0.2.470",
+  version: "0.2.472",
   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": "@zernio/node",
-  "version": "0.2.470",
+  "version": "0.2.472",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -6670,6 +6670,8 @@ export const listAdCampaigns = <ThrowOnError extends boolean = false>(options?:
  * (CBO) by definition; omit it for ABO (each ad set carries its own budget). Created
  * `PAUSED` unless `status: ACTIVE`. The campaign materializes in `/v1/ads/tree` via the
  * next sync discovery pass.
+ *
+ * **Idempotency:** send an `Idempotency-Key` header to make retries safe.
  */
 export const createAdCampaign = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateAdCampaignData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateAdCampaignResponse, CreateAdCampaignError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -450,7 +450,7 @@ export type AdMetrics = {
     cpm?: number;
     engagement?: number;
     /**
-     * Count of conversion events over the requested date range. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
+     * Count of conversion events over the requested date range. FRACTIONAL: attribution splits one conversion across touchpoints and Google additionally reports modeled conversions, so values like 0.347 are normal. Meta: events matching the campaign's promoted_object.custom_event_type (PURCHASE, LEAD, etc.). Google: the account's tracked conversions. X and LinkedIn: their reported website/lead conversions (added 2026-07). 0 for non-conversion campaigns or when no events have fired.
      */
     conversions?: number;
     /**
@@ -4456,7 +4456,7 @@ export type TargetingSpec = {
     ageMin?: number;
     ageMax?: number;
     /**
-     * Restrict by gender. 'all' (default) targets everyone.
+     * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
      */
     gender?: 'all' | 'male' | 'female';
     /**
@@ -4513,7 +4513,7 @@ export type TargetingSpec = {
 };
 
 /**
- * Restrict by gender. 'all' (default) targets everyone.
+ * Restrict by gender. 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
  */
 export type gender = 'all' | 'male' | 'female';
 
@@ -25068,6 +25068,24 @@ export type CreateAdCampaignData = {
         budgetAmount?: number;
         budgetType?: 'daily' | 'lifetime';
         status?: 'ACTIVE' | 'PAUSED';
+        /**
+         * Campaign bid strategy. Meta puts `bid_strategy` where the budget lives, so this applies only alongside a campaign budget (CBO). Previously settable only via `PUT /v1/ads/campaigns/{campaignId}`.
+         */
+        bidStrategy?: 'LOWEST_COST_WITHOUT_CAP' | 'LOWEST_COST_WITH_BID_CAP' | 'COST_CAP' | 'LOWEST_COST_WITH_MIN_ROAS';
+        /**
+         * Whole currency units (USD: 5 = $5.00). Required for LOWEST_COST_WITH_BID_CAP and COST_CAP; ignored otherwise.
+         */
+        bidAmount?: number;
+        /**
+         * Decimal ROAS multiplier (2.0 = 2.0x). Required for LOWEST_COST_WITH_MIN_ROAS.
+         */
+        roasAverageFloor?: number;
+    };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
     };
 };
 
@@ -25253,6 +25271,12 @@ export type DuplicateAdCampaignData = {
          */
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform campaign ID
@@ -25301,6 +25325,12 @@ export type DuplicateAdSetData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Source platform ad set ID
@@ -25339,6 +25369,12 @@ export type DuplicateAdData = {
         renameSuffix?: string;
         syncAfter?: boolean;
     };
+    headers?: {
+        /**
+         * Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.
+         */
+        'Idempotency-Key'?: string;
+    };
     path: {
         /**
          * Zernio ad ID or platform ad ID
@@ -25649,7 +25685,7 @@ export type GetAdsTimelineResponse = ({
          */
         cpm?: number;
         /**
-         * Sum of conversion events over the range. Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
+         * Sum of conversion events over the range. Fractional values are normal (attribution splitting + Google modeled conversions). Meta: events matching the campaign optimization goal. Google: tracked conversions. X / LinkedIn: reported website/lead conversions (added 2026-07).
          */
         conversions?: number;
         costPerConversion?: number;
@@ -27271,7 +27307,7 @@ export type BoostPostData = {
             ageMin?: number;
             ageMax?: number;
             /**
-             * Meta only.
+             * Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
              */
             gender?: 'all' | 'male' | 'female';
             /**
@@ -27614,9 +27650,13 @@ export type CreateStandaloneAdData = {
          */
         video?: {
             /**
-             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s.
+             * Public URL of the video. Meta: uploaded via chunked transfer on /act_X/advideos, then the request blocks on Meta's transcoding until status.video_status === 'ready'. LinkedIn: uploaded via the Videos API (multipart), then the request blocks until LinkedIn finishes transcoding (status AVAILABLE) — short clips take ~10-30s. Provide either `url` or `id`.
              */
-            url: string;
+            url?: string;
+            /**
+             * Meta only. Reuse a video ALREADY uploaded to this ad account instead of re-uploading the file: pass the `videoId` returned by a previous create. Wins over `url`, so N ads that differ only in copy share one upload (`existingCreativeId` only covers the identical-copy case). Provide either `url` or `id`.
+             */
+            id?: string;
             /**
              * Public URL of a still-image thumbnail for the video. OPTIONAL: when omitted on Meta, the poster is auto-generated from Meta's own preferred video thumbnail (the same candidates Ads Manager shows), so video ads publish without supplying one. Provide it to control the poster frame exactly (uploaded as an ad image and referenced in object_story_spec.video_data). Ignored by LinkedIn (auto-generated poster frame).
              */
@@ -27973,6 +28013,54 @@ export type CreateStandaloneAdData = {
              */
             callToAction?: string;
         }>;
+        /**
+         * 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.
+         */
+        defaultLocale?: string;
+        /**
+         * Meta only. Multi-language ads (Dynamic Language Optimization): ONE ad carrying
+         * per-locale copy and, optionally, per-locale media — the "Languages" toggle in Ads
+         * Manager. Keeps social proof (likes/comments/shares) on a SINGLE post instead of
+         * splitting it across one ad per language.
+         *
+         * The ad's top-level copy and media are the DEFAULT every unlisted locale falls back
+         * to, and a variant inherits any field it omits, so send only what differs per
+         * language. Media shared across languages is uploaded once.
+         *
+         * Mutually exclusive with `dynamicCreative`, `placementAssets`, `carouselCards` and
+         * `existingCreativeId` — Meta allows one `asset_feed_spec` shape per creative.
+         *
+         */
+        translations?: Array<{
+            /**
+             * Language code, resolved to Meta's numeric locale id. Bare codes target the '(All)' umbrella (`es` = every Spanish variant); region-qualified codes target the variant (`pt_BR`, `en_GB`).
+             */
+            locale: string;
+            /**
+             * Headline for this language. Inherits the top-level `headline` when omitted.
+             */
+            headline?: string;
+            /**
+             * Primary text for this language. Inherits the top-level `body` when omitted.
+             */
+            body?: string;
+            /**
+             * Link description for this language. Inherits the top-level `description` when omitted.
+             */
+            description?: string;
+            /**
+             * Image for this language. Inherits the ad's `imageUrl` when omitted. The feed is all-image OR all-video.
+             */
+            imageUrl?: string;
+            /**
+             * Video for this language. Inherits the ad's `video.url` when omitted. The feed is all-image OR all-video.
+             */
+            videoUrl?: string;
+            /**
+             * Poster frame for this language's video.
+             */
+            thumbnailUrl?: string;
+        }>;
         /**
          * Meta only. Placement asset customization: pin a SPECIFIC asset (image OR video) to
          * each placement group on a SINGLE ad (e.g. a 9:16 on Stories/Reels and a 4:5 on Feed).
@@ -28083,7 +28171,7 @@ export type CreateStandaloneAdData = {
             windowDays: 1 | 7 | 28;
         }>;
         /**
-         * Meta only. Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Ignored by non-Meta platforms.
+         * Restrict the audience by gender. 'male' targets men only, 'female' targets women only, 'all' (default) targets everyone. Applied on Meta, TikTok and Pinterest. Ignored on Google, LinkedIn and X.
          */
         gender?: 'all' | 'male' | 'female';
         /**