@getlatedev/node 0.2.1177 → 0.2.1179

package/dist/index.d.mts

@@ -6233,7 +6233,9 @@ type CtwaAdRequestBody = {
     whatsappPhoneNumber?: string;
     /**
      * Single-creative shape only. Mutually exclusive with
-     * `creatives[]`.
+     * `creatives[]`. Required on a single image or video ad (including
+     * one built with `placementAssets`); not used by a `carouselCards`
+     * ad and not accepted with an existing post reference.
      *
      */
     headline?: string;
@@ -6323,7 +6325,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 as `link_data.child_attachments`; every
+     * 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
      * 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
@@ -6400,7 +6404,7 @@ type CtwaAdRequestBody = {
             thumbnailUrl?: string;
         };
         /**
-         * Custom chat welcome message for this entry. See the top-level `welcomeMessage` for the single-creative shape.
+         * Custom chat welcome message for this entry: `text` plus exactly one of `prefillText` or `quickReplies` (400 otherwise). Same shape as the top-level `welcomeMessage` of the single-creative shape.
          */
         welcomeMessage?: {
             /**
@@ -6408,9 +6412,22 @@ type CtwaAdRequestBody = {
              */
             text: string;
             /**
-             * Message put into the user's text input, ready to send. Replaces Meta's default.
+             * Message put into the user's text input, ready to send. Replaces Meta's default. Exactly one of prefillText or quickReplies.
              */
-            prefillText: string;
+            prefillText?: string;
+            /**
+             * Tappable chips under the greeting instead of a prefilled message. Exactly one of prefillText or quickReplies.
+             */
+            quickReplies?: Array<{
+                /**
+                 * Chip label the person taps.
+                 */
+                title: string;
+                /**
+                 * Opaque string you choose; delivered on the message.received webhook as interactiveMetadata.quickReplyPayload when the chip is tapped.
+                 */
+                payload: string;
+            }>;
         };
         /**
          * A 2-10 card carousel for this entry instead of `imageUrl` / `video`; `body` is required. Same rules as the top-level `carouselCards`. Carousel and single-media entries can be mixed on one ad set.
@@ -10717,7 +10734,7 @@ type ParameterCatalogProductId = string;
  */
 type ParameterCatalogTokenAccountId = string;
 /**
- * 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.
+ * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  */
 type ParameterIdempotencyKeyHeader = string;
 /**
@@ -15919,9 +15936,12 @@ type WebhookPayloadMessageSent = {
          * on the inbox analytics endpoints, and the same value a later
          * GET on this message returns.
          *
-         * Always present, and `null` whenever the lineage is unknown: a
-         * message sent from the platform's own app, and every message
-         * stored before this field shipped (2026-08). Existing messages
+         * Always present, and `null` whenever the lineage is unknown: any
+         * outgoing message not sent through Zernio (one typed in the
+         * platform's own app, a Meta automated reply such as an instant
+         * reply or away message, the echo of a click-to-message ad's
+         * greeting), and every message stored before this field shipped
+         * (2026-08). Existing messages
          * are NOT backfilled, so treat `null` as "unknown", never as
          * "sent by a human".
          *
@@ -20540,7 +20560,7 @@ type CreateProfileData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -21670,7 +21690,7 @@ type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -21729,7 +21749,8 @@ type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -29367,7 +29388,7 @@ type SendInboxMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -29728,7 +29749,7 @@ type RemoveMessageReactionError = (unknown | ErrorResponse);
 type UploadMediaDirectData = {
     body: {
         /**
-         * The file to upload (max 25MB)
+         * The file to upload (about 4.5 MB at most in practice; use POST /v1/media/presign for larger files)
          */
         file: (Blob | File);
         /**
@@ -30395,7 +30416,7 @@ type ReplyToInboxPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31230,7 +31251,7 @@ type ReplyToInboxReviewData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31811,7 +31832,7 @@ type InitiateWhatsAppCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32050,7 +32071,7 @@ type CreateVoiceCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32644,7 +32665,7 @@ type SendSmsData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32695,7 +32716,7 @@ type CreateRcsAgentData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32812,7 +32833,7 @@ type SendRcsMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32993,7 +33014,7 @@ type CreateBrandedCallingEnterpriseData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -33073,7 +33094,7 @@ type CreateBrandedCallingIdentityData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -38693,7 +38714,7 @@ type AskSupportQuestionData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -46987,7 +47008,7 @@ type BoostPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -47885,9 +47906,11 @@ type CreateStandaloneAdData = {
          * (card `callToAction`, falling back to the top-level one) and caption (card
          * `headline`, else `description`). `headline` is still required.
          *
-         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * 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 control the card order and per-card copy/link. Requires top-level `body`
+         * 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`
          * 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.
@@ -48330,7 +48353,7 @@ type CreateStandaloneAdData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51370,7 +51393,7 @@ type CreateMessagingAdData = {
     });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51401,7 +51424,7 @@ type CreateCallAdData = {
     });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51412,7 +51435,7 @@ type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };

package/dist/index.d.ts

@@ -6233,7 +6233,9 @@ type CtwaAdRequestBody = {
     whatsappPhoneNumber?: string;
     /**
      * Single-creative shape only. Mutually exclusive with
-     * `creatives[]`.
+     * `creatives[]`. Required on a single image or video ad (including
+     * one built with `placementAssets`); not used by a `carouselCards`
+     * ad and not accepted with an existing post reference.
      *
      */
     headline?: string;
@@ -6323,7 +6325,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 as `link_data.child_attachments`; every
+     * 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
      * 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
@@ -6400,7 +6404,7 @@ type CtwaAdRequestBody = {
             thumbnailUrl?: string;
         };
         /**
-         * Custom chat welcome message for this entry. See the top-level `welcomeMessage` for the single-creative shape.
+         * Custom chat welcome message for this entry: `text` plus exactly one of `prefillText` or `quickReplies` (400 otherwise). Same shape as the top-level `welcomeMessage` of the single-creative shape.
          */
         welcomeMessage?: {
             /**
@@ -6408,9 +6412,22 @@ type CtwaAdRequestBody = {
              */
             text: string;
             /**
-             * Message put into the user's text input, ready to send. Replaces Meta's default.
+             * Message put into the user's text input, ready to send. Replaces Meta's default. Exactly one of prefillText or quickReplies.
              */
-            prefillText: string;
+            prefillText?: string;
+            /**
+             * Tappable chips under the greeting instead of a prefilled message. Exactly one of prefillText or quickReplies.
+             */
+            quickReplies?: Array<{
+                /**
+                 * Chip label the person taps.
+                 */
+                title: string;
+                /**
+                 * Opaque string you choose; delivered on the message.received webhook as interactiveMetadata.quickReplyPayload when the chip is tapped.
+                 */
+                payload: string;
+            }>;
         };
         /**
          * A 2-10 card carousel for this entry instead of `imageUrl` / `video`; `body` is required. Same rules as the top-level `carouselCards`. Carousel and single-media entries can be mixed on one ad set.
@@ -10717,7 +10734,7 @@ type ParameterCatalogProductId = string;
  */
 type ParameterCatalogTokenAccountId = string;
 /**
- * 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.
+ * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  */
 type ParameterIdempotencyKeyHeader = string;
 /**
@@ -15919,9 +15936,12 @@ type WebhookPayloadMessageSent = {
          * on the inbox analytics endpoints, and the same value a later
          * GET on this message returns.
          *
-         * Always present, and `null` whenever the lineage is unknown: a
-         * message sent from the platform's own app, and every message
-         * stored before this field shipped (2026-08). Existing messages
+         * Always present, and `null` whenever the lineage is unknown: any
+         * outgoing message not sent through Zernio (one typed in the
+         * platform's own app, a Meta automated reply such as an instant
+         * reply or away message, the echo of a click-to-message ad's
+         * greeting), and every message stored before this field shipped
+         * (2026-08). Existing messages
          * are NOT backfilled, so treat `null` as "unknown", never as
          * "sent by a human".
          *
@@ -20540,7 +20560,7 @@ type CreateProfileData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -21670,7 +21690,7 @@ type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -21729,7 +21749,8 @@ type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -29367,7 +29388,7 @@ type SendInboxMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -29728,7 +29749,7 @@ type RemoveMessageReactionError = (unknown | ErrorResponse);
 type UploadMediaDirectData = {
     body: {
         /**
-         * The file to upload (max 25MB)
+         * The file to upload (about 4.5 MB at most in practice; use POST /v1/media/presign for larger files)
          */
         file: (Blob | File);
         /**
@@ -30395,7 +30416,7 @@ type ReplyToInboxPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31230,7 +31251,7 @@ type ReplyToInboxReviewData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31811,7 +31832,7 @@ type InitiateWhatsAppCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32050,7 +32071,7 @@ type CreateVoiceCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32644,7 +32665,7 @@ type SendSmsData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32695,7 +32716,7 @@ type CreateRcsAgentData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32812,7 +32833,7 @@ type SendRcsMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32993,7 +33014,7 @@ type CreateBrandedCallingEnterpriseData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -33073,7 +33094,7 @@ type CreateBrandedCallingIdentityData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -38693,7 +38714,7 @@ type AskSupportQuestionData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -46987,7 +47008,7 @@ type BoostPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -47885,9 +47906,11 @@ type CreateStandaloneAdData = {
          * (card `callToAction`, falling back to the top-level one) and caption (card
          * `headline`, else `description`). `headline` is still required.
          *
-         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * 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 control the card order and per-card copy/link. Requires top-level `body`
+         * 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`
          * 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.
@@ -48330,7 +48353,7 @@ type CreateStandaloneAdData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51370,7 +51393,7 @@ type CreateMessagingAdData = {
     });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51401,7 +51424,7 @@ type CreateCallAdData = {
     });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -51412,7 +51435,7 @@ type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -4379,7 +4379,10 @@ export const removeMessageReaction = <ThrowOnError extends boolean = false>(opti
  * The URL can be used as attachmentUrl when sending inbox messages.
  *
  * Files are stored in temporary storage and auto-delete after 7 days.
- * Maximum file size is 25MB.
+ * The effective maximum is about 4.5 MB: the multipart body goes through
+ * the hosting platform's request body limit, which answers 413 before the
+ * endpoint's own 25 MB check is reached. For larger files use
+ * POST /v1/media/presign and upload straight to storage.
  *
  * Unlike /v1/media/upload (which uses upload tokens for end-user flows),
  * this endpoint takes your API key in the Authorization header, for programmatic use.
@@ -12810,11 +12813,23 @@ export const replaceGoogleListingGroupFilters = <ThrowOnError extends boolean =
  *
  * Per-platform required fields, budget minimums, and video-ad rules are documented on each property below.
  *
+ * **Meta required fields per shape** (a missing one is a 400 naming it in `param`):
+ *
+ * - Every shape that builds a new ad set (no `adSetId`, `existingCampaignId` or `buyingType: "RESERVED"`): `budgetAmount` and `budgetType`, plus `endDate` for a lifetime budget.
+ * - Single image or video (the default), also with `adSetId`: `headline` (max 255), `body`, `callToAction`, exactly one of `imageUrl` / `video` (none for goal `catalog_sales`), and `linkUrl` unless the goal is `lead_generation` or `page_visits` or `leadGenFormId` is set.
+ * - `bodies[]` / `headlines[]` text variations: `body`, one list with 2+ items, `callToAction`, `imageUrl` or `video`, and `linkUrl` unless the goal is `lead_generation` or `leadGenFormId` is set. `headline` is not required.
+ * - `placementAssets`: `headline`, `body`, `callToAction`, and `linkUrl` with the same exemptions as the single shape; the media comes from `placementAssets`.
+ * - `carouselCards`: `body`, `callToAction`, and `linkUrl` unless the goal is `lead_generation` or `leadGenFormId` is set. `headline` is not required.
+ * - `creatives[]`: per entry `headline`, `body`, `callToAction`, `imageUrl` or `video`, and `linkUrl` unless the goal is `lead_generation`. Top-level `body` is not required.
+ * - `dynamicCreative`: `imageUrls` or `videoUrls`, `callToActionTypes`, and `linkUrls` unless the goal is `lead_generation`. Top-level `body` is not required.
+ * - `existingCreativeId`: no creative fields. Goal `page_likes`: `body` only.
+ * - Goal `lead_generation` always needs `leadGenFormId`, except with `existingCreativeId`.
+ *
  * LinkedIn creates a Single Image or Single Video Ad backed by a Direct Sponsored Content "dark post" authored by a Company Page (see `organizationId`). Supported goals are engagement, traffic, awareness, and video_views (video ads use the `video` field; video_views requires a video), and traffic ads require `linkUrl`.
  *
  * Reddit Ads (`accountId` of a `redditads` connection, `adAccountId` like `a2_abc123`) creates a campaign, an ad group carrying the budget, schedule, targeting and pixel, and an ad running a new promoted post authored by the ad account's first profile (422 when it has none). The creative format follows the body: `carouselCards` builds a carousel, `video` a video ad, `imageUrl` an image ad, and none of them a text ad, which cannot link out (`linkUrl` is a 400 there; `body` is required). Only the legacy single-creative shape is available: `creatives[]`, `adSetId`, `existingCampaignId` and `validateOnly` are refused. Reddit throttling surfaces as 429 `rate_limited` with `platform: reddit`; retry after a delay. To promote an existing Reddit post use POST /v1/ads/boost.
  *
- * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
+ * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). If the first request is cut off mid-create (for example by a function timeout), its key can stay in progress and keep returning 409 until it expires; use a new key to retry sooner, after checking whether the ad was created. Keys are scoped to your credential and expire after 24h.
  *
  */
 export const createStandaloneAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateStandaloneAdData, ThrowOnError>) => {
@@ -14429,9 +14444,19 @@ export const sendWhatsAppConversion = <ThrowOnError extends boolean = false>(opt
  * `accountId` is a Facebook, Instagram or Meta ads (business login) connection;
  * `pageId` picks the Page when that connection was granted several.
  *
+ * **Required fields per shape** (a missing one is a 400 naming it in `param`):
+ *
+ * - Always `accountId`, `adAccountId`, `name`, and exactly one of `destination` / `destinations`.
+ * - `budgetAmount` and `budgetType` unless `adSetId` or `existingCampaignId` is set, plus `endDate` for a lifetime budget.
+ * - Single image or video: `headline`, `body`, and exactly one of `imageUrl` / `video`. With `placementAssets`, `headline` and `body` only (the media comes from `placementAssets`).
+ * - `carouselCards`: `body` and the 2-10 cards; `headline` is optional, `imageUrl` / `video` / top-level `description` are a 400.
+ * - Existing post (`platformPostId` or `objectStoryId`): no copy or media fields.
+ * - `creatives[]`: the same rules per entry, with no top-level creative fields.
+ * - `welcomeMessage`, when sent: `text` plus exactly one of `prefillText` / `quickReplies`.
+ *
  * **WhatsApp number prerequisite.** For the WhatsApp destination, link the WhatsApp number to the Facebook Page used for the ad before creating it: Meta checks the pairing at creation. Link it from the WhatsApp Business app (Settings > Business tools > Facebook & Instagram) or from the Page settings (Linked accounts > WhatsApp). Linking does not affect the number's WhatsApp connection in Zernio (Cloud API or coexistence), so no reconnect or re-sync is needed. If Meta creates a new ad set without the requested `whatsappPhoneNumber`, the 201 response carries a `warnings` entry. This can happen even when the number is linked (Meta can drop a Page's second linked number).
  *
- * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
+ * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). If the first request is cut off mid-create (for example by a function timeout), its key can stay in progress and keep returning 409 until it expires; use a new key to retry sooner, after checking whether the ad was created. Keys are scoped to your credential and expire after 24h.
  */
 export const createMessagingAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateMessagingAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateMessagingAdResponse, CreateMessagingAdError, ThrowOnError>({
@@ -14449,7 +14474,7 @@ export const createMessagingAd = <ThrowOnError extends boolean = false>(options:
  * and the campaign objective defaults to OUTCOME_LEADS.
  * Supports the same single-creative and multi-creative shapes as CTWA.
  *
- * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
+ * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). If the first request is cut off mid-create (for example by a function timeout), its key can stay in progress and keep returning 409 until it expires; use a new key to retry sooner, after checking whether the ad was created. Keys are scoped to your credential and expire after 24h.
  */
 export const createCallAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateCallAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateCallAdResponse, CreateCallAdError, ThrowOnError>({
@@ -14481,7 +14506,7 @@ export const createCallAd = <ThrowOnError extends boolean = false>(options: Opti
  *
  * **WhatsApp number prerequisite.** Link the WhatsApp number to the Facebook Page used for the ad before creating it: Meta checks the pairing at creation. Link it from the WhatsApp Business app (Settings > Business tools > Facebook & Instagram) or from the Page settings (Linked accounts > WhatsApp). Linking does not affect the number's WhatsApp connection in Zernio (Cloud API or coexistence), so no reconnect or re-sync is needed. If Meta creates a new ad set without the requested `whatsappPhoneNumber`, the 201 response carries a `warnings` entry. This can happen even when the number is linked (Meta can drop a Page's second linked number).
  *
- * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). Keys are scoped to your credential and expire after 24h.
+ * **Idempotency:** this endpoint is not idempotent at the platform level (a blind retry creates a second campaign/ad set/ad). Send an `Idempotency-Key` header to make retries safe: the first request with a given key creates the ad and we store the response; a retry with the same key replays that exact response (with `Idempotent-Replayed: true`) instead of creating duplicates. Reusing a key with a different body returns 422; a key whose first request is still in flight returns 409 (retry after a short backoff). If the first request is cut off mid-create (for example by a function timeout), its key can stay in progress and keep returning 409 until it expires; use a new key to retry sooner, after checking whether the ad was created. Keys are scoped to your credential and expire after 24h.
  */
 export const createCtwaAd = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateCtwaAdData, ThrowOnError>) => {
     return (options?.client ?? client).post<CreateCtwaAdResponse, CreateCtwaAdError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -4412,7 +4412,9 @@ export type CtwaAdRequestBody = {
     whatsappPhoneNumber?: string;
     /**
      * Single-creative shape only. Mutually exclusive with
-     * `creatives[]`.
+     * `creatives[]`. Required on a single image or video ad (including
+     * one built with `placementAssets`); not used by a `carouselCards`
+     * ad and not accepted with an existing post reference.
      *
      */
     headline?: string;
@@ -4502,7 +4504,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 as `link_data.child_attachments`; every
+     * 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
      * 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
@@ -4579,7 +4583,7 @@ export type CtwaAdRequestBody = {
             thumbnailUrl?: string;
         };
         /**
-         * Custom chat welcome message for this entry. See the top-level `welcomeMessage` for the single-creative shape.
+         * Custom chat welcome message for this entry: `text` plus exactly one of `prefillText` or `quickReplies` (400 otherwise). Same shape as the top-level `welcomeMessage` of the single-creative shape.
          */
         welcomeMessage?: {
             /**
@@ -4587,9 +4591,22 @@ export type CtwaAdRequestBody = {
              */
             text: string;
             /**
-             * Message put into the user's text input, ready to send. Replaces Meta's default.
+             * Message put into the user's text input, ready to send. Replaces Meta's default. Exactly one of prefillText or quickReplies.
              */
-            prefillText: string;
+            prefillText?: string;
+            /**
+             * Tappable chips under the greeting instead of a prefilled message. Exactly one of prefillText or quickReplies.
+             */
+            quickReplies?: Array<{
+                /**
+                 * Chip label the person taps.
+                 */
+                title: string;
+                /**
+                 * Opaque string you choose; delivered on the message.received webhook as interactiveMetadata.quickReplyPayload when the chip is tapped.
+                 */
+                payload: string;
+            }>;
         };
         /**
          * A 2-10 card carousel for this entry instead of `imageUrl` / `video`; `body` is required. Same rules as the top-level `carouselCards`. Carousel and single-media entries can be mixed on one ad set.
@@ -9087,7 +9104,7 @@ export type ParameterCatalogProductId = string;
 export type ParameterCatalogTokenAccountId = string;
 
 /**
- * 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.
+ * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
  */
 export type ParameterIdempotencyKeyHeader = string;
 
@@ -14507,9 +14524,12 @@ export type WebhookPayloadMessageSent = {
          * on the inbox analytics endpoints, and the same value a later
          * GET on this message returns.
          *
-         * Always present, and `null` whenever the lineage is unknown: a
-         * message sent from the platform's own app, and every message
-         * stored before this field shipped (2026-08). Existing messages
+         * Always present, and `null` whenever the lineage is unknown: any
+         * outgoing message not sent through Zernio (one typed in the
+         * platform's own app, a Meta automated reply such as an instant
+         * reply or away message, the echo of a click-to-message ad's
+         * greeting), and every message stored before this field shipped
+         * (2026-08). Existing messages
          * are NOT backfilled, so treat `null` as "unknown", never as
          * "sent by a human".
          *
@@ -19413,7 +19433,7 @@ export type CreateProfileData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -20621,7 +20641,7 @@ export type GetConnectUrlData = {
          *
          * `facebook_login`: the Facebook Login dialog, i.e. "Instagram API with Facebook Login". The user authorizes a Facebook Page that has a linked Instagram professional account, and every API call for that account then runs through the Page. Use this when the customer manages Instagram through a Page and expects the Facebook consent screen. Because the user has to pick which Page to connect, the callback continues at the account-selection step, `/v1/connect/instagram/select-account`.
          *
-         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account` and `connect_token`, which you pass into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
+         * `facebook_login` supports `headless=true` like the other selection platforms: the callback redirects to your `redirect_url` with `profileId`, `tempToken`, `platform=instagram`, `step=select_account`, `userProfile` (the Facebook user's profile, same shape and encoding as the Facebook `step=select_page` redirect) and `connect_token`. Pass `profileId`, `tempToken` and `connect_token` into the select-account endpoints to finish. The default `instagram_login` has no selection step, so it connects the account directly.
          *
          */
         loginMethod?: 'instagram_login' | 'facebook_login';
@@ -20680,7 +20700,8 @@ export type GetConnectUrlData = {
          * - `granted_pages_not_listed`: Pages were ticked but Meta listed none the user can manage, and a
          * direct read of each ticked Page returned no access token.
          *
-         * Headless Facebook success (`step=select_page`): `userProfile` is JSON that was
+         * Headless Facebook success (`step=select_page`) and headless Instagram `facebook_login` success
+         * (`step=select_account`): `userProfile` is JSON that was
          * percent-encoded once before being set as a query param, so it is encoded twice on the wire.
          * After your framework decodes the query string once, run one more decodeURIComponent (or
          * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
@@ -28753,7 +28774,7 @@ export type SendInboxMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -29144,7 +29165,7 @@ export type RemoveMessageReactionError = (unknown | ErrorResponse);
 export type UploadMediaDirectData = {
     body: {
         /**
-         * The file to upload (max 25MB)
+         * The file to upload (about 4.5 MB at most in practice; use POST /v1/media/presign for larger files)
          */
         file: (Blob | File);
         /**
@@ -29877,7 +29898,7 @@ export type ReplyToInboxPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -30784,7 +30805,7 @@ export type ReplyToInboxReviewData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31410,7 +31431,7 @@ export type InitiateWhatsAppCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -31673,7 +31694,7 @@ export type CreateVoiceCallData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32351,7 +32372,7 @@ export type SendSmsData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32410,7 +32431,7 @@ export type CreateRcsAgentData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32554,7 +32575,7 @@ export type SendRcsMessageData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32758,7 +32779,7 @@ export type CreateBrandedCallingEnterpriseData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -32854,7 +32875,7 @@ export type CreateBrandedCallingIdentityData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -38968,7 +38989,7 @@ export type AskSupportQuestionData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -47778,7 +47799,7 @@ export type BoostPostData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -48700,9 +48721,11 @@ export type CreateStandaloneAdData = {
          * (card `callToAction`, falling back to the top-level one) and caption (card
          * `headline`, else `description`). `headline` is still required.
          *
-         * Meta only. Hand-built carousel: 2-10 authored cards in DETERMINISTIC order, mapped to
+         * 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 control the card order and per-card copy/link. Requires top-level `body`
+         * 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`
          * 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.
@@ -49145,7 +49168,7 @@ export type CreateStandaloneAdData = {
     };
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -52404,7 +52427,7 @@ export type CreateMessagingAdData = {
 });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -52438,7 +52461,7 @@ export type CreateCallAdData = {
 });
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };
@@ -52452,7 +52475,7 @@ export type CreateCtwaAdData = {
     body: CtwaAdRequestBody;
     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.
+         * 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. A request cut off mid-handler (for example by a function timeout) can leave its key in progress, answering 409 until the key expires after 24 hours.
          */
         'Idempotency-Key'?: string;
     };