@getlatedev/node 0.2.261 → 0.2.263

package/dist/index.d.mts

@@ -805,7 +805,7 @@ type AccountWithFollowerStats = SocialAccount & {
          */
         mediaCount?: number;
         /**
-         * Total videos (YouTube
+         * Total videos (YouTube, TikTok)
          */
         videoCount?: number;
         /**
@@ -1904,7 +1904,7 @@ type DiscordPlatformData = {
         };
         footer?: {
             /**
-             * Footer text (max 2
+             * Footer text (max 2,048 chars)
              */
             text?: string;
             icon_url?: string;
@@ -1926,7 +1926,7 @@ type DiscordPlatformData = {
              */
             name: string;
             /**
-             * Field value (max 1
+             * Field value (max 1,024 chars)
              */
             value: string;
             /**
@@ -3366,7 +3366,7 @@ type RedditPost = {
     author?: string;
     subreddit?: string;
     /**
-     * Post URL (may be a gallery URL
+     * Post URL (may be a gallery URL, external link, or self-post URL)
      */
     url?: string;
     /**
@@ -3456,7 +3456,7 @@ type SharedAdAccount = {
     id: string;
     name?: string;
     /**
-     * Business Manager id that owns the ad account
+     * Business Manager id that owns the ad account, when reported.
      */
     businessId?: string;
 };
@@ -4814,7 +4814,7 @@ type WebhookPayloadConversationStarted = {
         platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
         platformConversationId: string;
         /**
-         * Contact's platform identifier (IGSID
+         * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
          */
         participantId?: string;
         participantName: string;
@@ -8799,7 +8799,7 @@ type ConfigureTikTokAdsBrandIdentityData = {
 type ConfigureTikTokAdsBrandIdentityResponse = ({
     success?: boolean;
     /**
-     * The TikTok-assigned identity_id
+     * The TikTok-assigned identity_id, cached on the account.
      */
     identityId?: string;
     displayName?: string;
@@ -9114,7 +9114,7 @@ type GetGoogleBusinessVerificationsResponse = ({
      */
     voiceOfMerchantState?: {
         /**
-         * True when the listing is verified and published (eligible to surface reviews
+         * True when the listing is verified and published (eligible to surface reviews, edits, etc.).
          */
         hasVoiceOfMerchant?: boolean;
         /**
@@ -10080,7 +10080,7 @@ type BatchGetGoogleBusinessReviewsResponse = ({
          */
         name?: string;
         /**
-         * The review object (reviewId
+         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
          */
         review?: {
             [key: string]: unknown;
@@ -12740,7 +12740,7 @@ type GetInboxConversationMessagesResponse = ({
         reactions?: Array<{
             emoji?: string;
             /**
-             * true if the connected account reacted
+             * true if the connected account reacted, false if the contact did.
              */
             fromMe?: boolean;
             reactedAt?: string;
@@ -13083,7 +13083,7 @@ type SendInboxMessageData = {
                  */
                 text?: string;
                 /**
-                 * Callback data (inline_keyboard only
+                 * Callback data (inline_keyboard only, max 64 bytes)
                  */
                 callbackData?: string;
                 /**
@@ -13657,11 +13657,11 @@ type GetInboxPostCommentsResponse = ({
         canReply?: boolean;
         canDelete?: boolean;
         /**
-         * Whether this comment can be hidden (Facebook
+         * Whether this comment can be hidden (Facebook, Instagram, Threads)
          */
         canHide?: boolean;
         /**
-         * Whether this comment can be liked (Facebook
+         * Whether this comment can be liked (Facebook, Twitter/X, Bluesky, Reddit)
          */
         canLike?: boolean;
         /**
@@ -13715,11 +13715,11 @@ type GetInboxPostCommentsResponse = ({
          */
         selftext?: string;
         /**
-         * Reddit username
+         * Reddit username, without the u/ prefix
          */
         author?: string;
         /**
-         * Subreddit name
+         * Subreddit name, without the r/ prefix
          */
         subreddit?: string;
         /**
@@ -13727,7 +13727,7 @@ type GetInboxPostCommentsResponse = ({
          */
         permalink?: string;
         /**
-         * For link posts
+         * For link posts, the external URL; for self-posts, the Reddit permalink
          */
         url?: string;
         /**
@@ -14486,7 +14486,7 @@ type EnableWhatsAppCallingData = {
         forwardTo: string;
         sipAuthUsername?: string;
         /**
-         * Stored encrypted
+         * Stored encrypted, never returned by any endpoint.
          */
         sipAuthPassword?: string;
         recordingEnabled?: boolean;
@@ -14541,7 +14541,7 @@ type GetWhatsAppCallPermissionsData = {
     query: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
     };
@@ -14566,7 +14566,7 @@ type InitiateWhatsAppCallData = {
     body: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
         /**
@@ -15130,7 +15130,7 @@ type GetWhatsAppPhoneNumbersResponse = ({
         country?: string;
         status?: 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
         /**
-         * For regulated numbers
+         * For regulated numbers, who it's registered for (company or person) — set from the submitted KYC.
          */
         registrantName?: (string) | null;
         /**
@@ -15472,7 +15472,7 @@ type ValidateWhatsAppNumberKycAddressData = {
          */
         locality: string;
         /**
-         * State / province / region. When omitted
+         * State / province / region. When omitted, the pre-check is skipped (the final submit still validates).
          */
         administrative_area?: string;
         postal_code: string;
@@ -17318,7 +17318,7 @@ type TriggerWorkflowData = {
          */
         conversationId?: string;
         /**
-         * Simulated inbound text
+         * Simulated inbound text, seeded as the run's lastMessage variable
          */
         text?: string;
     };
@@ -17415,7 +17415,7 @@ type ListWorkflowVersionsResponse = ({
          */
         createdByEmail?: (string) | null;
         /**
-         * When non-null
+         * When non-null, this snapshot was created by restoring that version
          */
         restoredFromVersion?: (number) | null;
         createdAt?: string;
@@ -18436,7 +18436,11 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
+         */
+        campaignId?: string;
+        /**
+         * Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -20300,7 +20304,7 @@ type GetConversionsQualityError = ({
 type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
         /**
@@ -20329,7 +20333,7 @@ type SendConversionsData = {
     };
 };
 type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     /**
      * Events accepted by the platform.
      */
@@ -20437,13 +20441,13 @@ type AdjustConversionsError = (unknown | {
 type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
     };
 };
 type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google:

package/dist/index.d.ts

@@ -805,7 +805,7 @@ type AccountWithFollowerStats = SocialAccount & {
          */
         mediaCount?: number;
         /**
-         * Total videos (YouTube
+         * Total videos (YouTube, TikTok)
          */
         videoCount?: number;
         /**
@@ -1904,7 +1904,7 @@ type DiscordPlatformData = {
         };
         footer?: {
             /**
-             * Footer text (max 2
+             * Footer text (max 2,048 chars)
              */
             text?: string;
             icon_url?: string;
@@ -1926,7 +1926,7 @@ type DiscordPlatformData = {
              */
             name: string;
             /**
-             * Field value (max 1
+             * Field value (max 1,024 chars)
              */
             value: string;
             /**
@@ -3366,7 +3366,7 @@ type RedditPost = {
     author?: string;
     subreddit?: string;
     /**
-     * Post URL (may be a gallery URL
+     * Post URL (may be a gallery URL, external link, or self-post URL)
      */
     url?: string;
     /**
@@ -3456,7 +3456,7 @@ type SharedAdAccount = {
     id: string;
     name?: string;
     /**
-     * Business Manager id that owns the ad account
+     * Business Manager id that owns the ad account, when reported.
      */
     businessId?: string;
 };
@@ -4814,7 +4814,7 @@ type WebhookPayloadConversationStarted = {
         platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
         platformConversationId: string;
         /**
-         * Contact's platform identifier (IGSID
+         * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
          */
         participantId?: string;
         participantName: string;
@@ -8799,7 +8799,7 @@ type ConfigureTikTokAdsBrandIdentityData = {
 type ConfigureTikTokAdsBrandIdentityResponse = ({
     success?: boolean;
     /**
-     * The TikTok-assigned identity_id
+     * The TikTok-assigned identity_id, cached on the account.
      */
     identityId?: string;
     displayName?: string;
@@ -9114,7 +9114,7 @@ type GetGoogleBusinessVerificationsResponse = ({
      */
     voiceOfMerchantState?: {
         /**
-         * True when the listing is verified and published (eligible to surface reviews
+         * True when the listing is verified and published (eligible to surface reviews, edits, etc.).
          */
         hasVoiceOfMerchant?: boolean;
         /**
@@ -10080,7 +10080,7 @@ type BatchGetGoogleBusinessReviewsResponse = ({
          */
         name?: string;
         /**
-         * The review object (reviewId
+         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
          */
         review?: {
             [key: string]: unknown;
@@ -12740,7 +12740,7 @@ type GetInboxConversationMessagesResponse = ({
         reactions?: Array<{
             emoji?: string;
             /**
-             * true if the connected account reacted
+             * true if the connected account reacted, false if the contact did.
              */
             fromMe?: boolean;
             reactedAt?: string;
@@ -13083,7 +13083,7 @@ type SendInboxMessageData = {
                  */
                 text?: string;
                 /**
-                 * Callback data (inline_keyboard only
+                 * Callback data (inline_keyboard only, max 64 bytes)
                  */
                 callbackData?: string;
                 /**
@@ -13657,11 +13657,11 @@ type GetInboxPostCommentsResponse = ({
         canReply?: boolean;
         canDelete?: boolean;
         /**
-         * Whether this comment can be hidden (Facebook
+         * Whether this comment can be hidden (Facebook, Instagram, Threads)
          */
         canHide?: boolean;
         /**
-         * Whether this comment can be liked (Facebook
+         * Whether this comment can be liked (Facebook, Twitter/X, Bluesky, Reddit)
          */
         canLike?: boolean;
         /**
@@ -13715,11 +13715,11 @@ type GetInboxPostCommentsResponse = ({
          */
         selftext?: string;
         /**
-         * Reddit username
+         * Reddit username, without the u/ prefix
          */
         author?: string;
         /**
-         * Subreddit name
+         * Subreddit name, without the r/ prefix
          */
         subreddit?: string;
         /**
@@ -13727,7 +13727,7 @@ type GetInboxPostCommentsResponse = ({
          */
         permalink?: string;
         /**
-         * For link posts
+         * For link posts, the external URL; for self-posts, the Reddit permalink
          */
         url?: string;
         /**
@@ -14486,7 +14486,7 @@ type EnableWhatsAppCallingData = {
         forwardTo: string;
         sipAuthUsername?: string;
         /**
-         * Stored encrypted
+         * Stored encrypted, never returned by any endpoint.
          */
         sipAuthPassword?: string;
         recordingEnabled?: boolean;
@@ -14541,7 +14541,7 @@ type GetWhatsAppCallPermissionsData = {
     query: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
     };
@@ -14566,7 +14566,7 @@ type InitiateWhatsAppCallData = {
     body: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
         /**
@@ -15130,7 +15130,7 @@ type GetWhatsAppPhoneNumbersResponse = ({
         country?: string;
         status?: 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
         /**
-         * For regulated numbers
+         * For regulated numbers, who it's registered for (company or person) — set from the submitted KYC.
          */
         registrantName?: (string) | null;
         /**
@@ -15472,7 +15472,7 @@ type ValidateWhatsAppNumberKycAddressData = {
          */
         locality: string;
         /**
-         * State / province / region. When omitted
+         * State / province / region. When omitted, the pre-check is skipped (the final submit still validates).
          */
         administrative_area?: string;
         postal_code: string;
@@ -17318,7 +17318,7 @@ type TriggerWorkflowData = {
          */
         conversationId?: string;
         /**
-         * Simulated inbound text
+         * Simulated inbound text, seeded as the run's lastMessage variable
          */
         text?: string;
     };
@@ -17415,7 +17415,7 @@ type ListWorkflowVersionsResponse = ({
          */
         createdByEmail?: (string) | null;
         /**
-         * When non-null
+         * When non-null, this snapshot was created by restoring that version
          */
         restoredFromVersion?: (number) | null;
         createdAt?: string;
@@ -18436,7 +18436,11 @@ type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
+         */
+        campaignId?: string;
+        /**
+         * Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -20300,7 +20304,7 @@ type GetConversionsQualityError = ({
 type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
         /**
@@ -20329,7 +20333,7 @@ type SendConversionsData = {
     };
 };
 type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     /**
      * Events accepted by the platform.
      */
@@ -20437,13 +20441,13 @@ type AdjustConversionsError = (unknown | {
 type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
     };
 };
 type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google:

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -5221,12 +5221,18 @@ export const getConversionsQuality = <ThrowOnError extends boolean = false>(opti
  * - Meta (`metaads`) via Graph API
  * - Google Ads (`googleads`) via Data Manager API `ingestEvents`
  * - LinkedIn (`linkedinads`) via `/rest/conversionEvents`
+ * - TikTok (`tiktokads`) via the Offline Events API `/offline/batch/` — OFFLINE conversions only
  *
  * `destinationId` semantics differ per platform:
  *
  * - Meta: pixel (dataset) ID, e.g. `123456789012345`
  * - Google: conversion action resource name, e.g. `customers/1234567890/conversionActions/987654321`
  * - LinkedIn: conversion rule ID or URN, e.g. `104012` or `urn:lla:llaPartnerConversion:104012`
+ * - TikTok: Offline Event Set ID, e.g. `7057103914977558530`
+ *
+ * TikTok notes: this path sends OFFLINE conversions (in-store / CRM / call-center), not web-pixel
+ * events. Each event must carry an email or phone (TikTok requires at least one). The connected
+ * TikTok ads account must have granted the Offline Events permission; older grants must reconnect.
  *
  * Callers can list valid destinations via `GET /v1/accounts/{accountId}/conversion-destinations`.
  *

package/src/generated/types.gen.ts

@@ -45,7 +45,7 @@ export type AccountWithFollowerStats = SocialAccount & {
          */
         mediaCount?: number;
         /**
-         * Total videos (YouTube
+         * Total videos (YouTube, TikTok)
          */
         videoCount?: number;
         /**
@@ -1179,7 +1179,7 @@ export type DiscordPlatformData = {
         };
         footer?: {
             /**
-             * Footer text (max 2
+             * Footer text (max 2,048 chars)
              */
             text?: string;
             icon_url?: string;
@@ -1201,7 +1201,7 @@ export type DiscordPlatformData = {
              */
             name: string;
             /**
-             * Field value (max 1
+             * Field value (max 1,024 chars)
              */
             value: string;
             /**
@@ -2729,7 +2729,7 @@ export type RedditPost = {
     author?: string;
     subreddit?: string;
     /**
-     * Post URL (may be a gallery URL
+     * Post URL (may be a gallery URL, external link, or self-post URL)
      */
     url?: string;
     /**
@@ -2822,7 +2822,7 @@ export type SharedAdAccount = {
     id: string;
     name?: string;
     /**
-     * Business Manager id that owns the ad account
+     * Business Manager id that owns the ad account, when reported.
      */
     businessId?: string;
 };
@@ -4239,7 +4239,7 @@ export type WebhookPayloadConversationStarted = {
         platform: 'instagram' | 'facebook' | 'telegram' | 'whatsapp' | 'twitter' | 'reddit' | 'bluesky';
         platformConversationId: string;
         /**
-         * Contact's platform identifier (IGSID
+         * Contact's platform identifier (IGSID, PSID, wa_id, etc.)
          */
         participantId?: string;
         participantName: string;
@@ -8491,7 +8491,7 @@ export type ConfigureTikTokAdsBrandIdentityData = {
 export type ConfigureTikTokAdsBrandIdentityResponse = ({
     success?: boolean;
     /**
-     * The TikTok-assigned identity_id
+     * The TikTok-assigned identity_id, cached on the account.
      */
     identityId?: string;
     displayName?: string;
@@ -8824,7 +8824,7 @@ export type GetGoogleBusinessVerificationsResponse = ({
      */
     voiceOfMerchantState?: {
         /**
-         * True when the listing is verified and published (eligible to surface reviews
+         * True when the listing is verified and published (eligible to surface reviews, edits, etc.).
          */
         hasVoiceOfMerchant?: boolean;
         /**
@@ -9850,7 +9850,7 @@ export type BatchGetGoogleBusinessReviewsResponse = ({
          */
         name?: string;
         /**
-         * The review object (reviewId
+         * The review object (reviewId, starRating, comment, reviewer, createTime, updateTime, reviewReply)
          */
         review?: {
             [key: string]: unknown;
@@ -12716,7 +12716,7 @@ export type GetInboxConversationMessagesResponse = ({
         reactions?: Array<{
             emoji?: string;
             /**
-             * true if the connected account reacted
+             * true if the connected account reacted, false if the contact did.
              */
             fromMe?: boolean;
             reactedAt?: string;
@@ -13061,7 +13061,7 @@ export type SendInboxMessageData = {
                  */
                 text?: string;
                 /**
-                 * Callback data (inline_keyboard only
+                 * Callback data (inline_keyboard only, max 64 bytes)
                  */
                 callbackData?: string;
                 /**
@@ -13690,11 +13690,11 @@ export type GetInboxPostCommentsResponse = ({
         canReply?: boolean;
         canDelete?: boolean;
         /**
-         * Whether this comment can be hidden (Facebook
+         * Whether this comment can be hidden (Facebook, Instagram, Threads)
          */
         canHide?: boolean;
         /**
-         * Whether this comment can be liked (Facebook
+         * Whether this comment can be liked (Facebook, Twitter/X, Bluesky, Reddit)
          */
         canLike?: boolean;
         /**
@@ -13748,11 +13748,11 @@ export type GetInboxPostCommentsResponse = ({
          */
         selftext?: string;
         /**
-         * Reddit username
+         * Reddit username, without the u/ prefix
          */
         author?: string;
         /**
-         * Subreddit name
+         * Subreddit name, without the r/ prefix
          */
         subreddit?: string;
         /**
@@ -13760,7 +13760,7 @@ export type GetInboxPostCommentsResponse = ({
          */
         permalink?: string;
         /**
-         * For link posts
+         * For link posts, the external URL; for self-posts, the Reddit permalink
          */
         url?: string;
         /**
@@ -14587,7 +14587,7 @@ export type EnableWhatsAppCallingData = {
         forwardTo: string;
         sipAuthUsername?: string;
         /**
-         * Stored encrypted
+         * Stored encrypted, never returned by any endpoint.
          */
         sipAuthPassword?: string;
         recordingEnabled?: boolean;
@@ -14651,7 +14651,7 @@ export type GetWhatsAppCallPermissionsData = {
     query: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
     };
@@ -14679,7 +14679,7 @@ export type InitiateWhatsAppCallData = {
     body: {
         accountId: string;
         /**
-         * Consumer wa_id (E.164
+         * Consumer wa_id (E.164, leading + optional)
          */
         to: string;
         /**
@@ -15295,7 +15295,7 @@ export type GetWhatsAppPhoneNumbersResponse = ({
         country?: string;
         status?: 'pending_payment' | 'pending_regulatory' | 'regulatory_declined' | 'provisioning' | 'verifying' | 'active' | 'suspended' | 'releasing' | 'released';
         /**
-         * For regulated numbers
+         * For regulated numbers, who it's registered for (company or person) — set from the submitted KYC.
          */
         registrantName?: (string) | null;
         /**
@@ -15659,7 +15659,7 @@ export type ValidateWhatsAppNumberKycAddressData = {
          */
         locality: string;
         /**
-         * State / province / region. When omitted
+         * State / province / region. When omitted, the pre-check is skipped (the final submit still validates).
          */
         administrative_area?: string;
         postal_code: string;
@@ -17693,7 +17693,7 @@ export type TriggerWorkflowData = {
          */
         conversationId?: string;
         /**
-         * Simulated inbound text
+         * Simulated inbound text, seeded as the run's lastMessage variable
          */
         text?: string;
     };
@@ -17800,7 +17800,7 @@ export type ListWorkflowVersionsResponse = ({
          */
         createdByEmail?: (string) | null;
         /**
-         * When non-null
+         * When non-null, this snapshot was created by restoring that version
          */
         restoredFromVersion?: (number) | null;
         createdAt?: string;
@@ -18904,7 +18904,11 @@ export type GetAdTreeData = {
          */
         adAccountId?: string;
         /**
-         * Start of metrics date range (YYYY-MM-DD). Defaults to 90 days ago.
+         * Restrict the tree to a single campaign by its platform campaign id (the id the platform assigns, e.g. Meta's numeric campaign id). Filters the campaign set itself, so it works regardless of account size and pagination — pass this when you already hold a campaign id instead of paging the tree to find it. Mirrors the `campaignId` filter on GET /v1/ads.
+         */
+        campaignId?: string;
+        /**
+         * Start of the METRICS date range (YYYY-MM-DD). Affects only the spend/impression numbers overlaid on each node, NOT which campaigns are returned. Defaults to 90 days ago.
          */
         fromDate?: string;
         /**
@@ -20861,7 +20865,7 @@ export type GetConversionsQualityError = ({
 export type SendConversionsData = {
     body: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
         /**
@@ -20891,7 +20895,7 @@ export type SendConversionsData = {
 };
 
 export type SendConversionsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     /**
      * Events accepted by the platform.
      */
@@ -21004,14 +21008,14 @@ export type AdjustConversionsError = (unknown | {
 export type ListConversionDestinationsData = {
     path: {
         /**
-         * SocialAccount ID (metaads, googleads, or linkedinads).
+         * SocialAccount ID (metaads, googleads, linkedinads, or tiktokads).
          */
         accountId: string;
     };
 };
 
 export type ListConversionDestinationsResponse = ({
-    platform?: 'metaads' | 'googleads' | 'linkedinads';
+    platform?: 'metaads' | 'googleads' | 'linkedinads' | 'tiktokads';
     destinations?: Array<{
         /**
          * Destination identifier. Meta: pixel ID. Google: