@getlatedev/node 0.2.483 → 0.2.485

package/dist/index.d.mts

@@ -1816,7 +1816,7 @@ type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent). When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -27942,6 +27942,12 @@ type CreateStandaloneAdData = {
             /**
              * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
              * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             * To discover the pixels an ad account can use, call
+             * `GET /v1/accounts/{accountId}/tracking-tags?adAccountId=act_...` (each entry
+             * carries `kind` and `ownerAdAccountId`), or
+             * `GET /v1/accounts/{accountId}/conversion-destinations`. Note this is a
+             * different resource from `GET /v1/ads/{adId}/tracking-tags`, which reads an
+             * ad's click-URL params (`url_tags`), not pixels.
              *
              */
             pixelId?: string;

package/dist/index.d.ts

@@ -1816,7 +1816,7 @@ type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent). When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -27942,6 +27942,12 @@ type CreateStandaloneAdData = {
             /**
              * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
              * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             * To discover the pixels an ad account can use, call
+             * `GET /v1/accounts/{accountId}/tracking-tags?adAccountId=act_...` (each entry
+             * carries `kind` and `ownerAdAccountId`), or
+             * `GET /v1/accounts/{accountId}/conversion-destinations`. Note this is a
+             * different resource from `GET /v1/ads/{adId}/tracking-tags`, which reads an
+             * ad's click-URL params (`url_tags`), not pixels.
              *
              */
             pixelId?: 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.483",
+  version: "0.2.485",
   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.483",
+  version: "0.2.485",
   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.483",
+  "version": "0.2.485",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -4128,10 +4128,10 @@ export const listSmsOptOuts = <ThrowOnError extends boolean = false>(options?: O
  * Constraints: 3-11 characters (letters, digits, spaces; at least one
  * letter). Sends cannot reach the US, Canada, or Puerto Rico, are
  * text-only, and recipients cannot reply. Sender IDs that impersonate
- * well-known brands or institutions are rejected, and an ID already
- * registered by another workspace returns 409 (active sender IDs are
- * globally unique, first-come-first-served). Creating the same sender ID
- * again is a no-op (re-activates it after a delete).
+ * well-known brands or institutions are rejected. Names are not
+ * exclusive: the same sender ID can be registered by any number of
+ * workspaces. Creating the same sender ID again is a no-op
+ * (re-activates it after a delete).
  *
  */
 export const createSmsSenderId = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<CreateSmsSenderIdData, ThrowOnError>) => {
@@ -6908,6 +6908,12 @@ export const updateAdSetStatus = <ThrowOnError extends boolean = false>(options:
  * (`campaign` default, or `adset` / `ad`) to choose which levels carry the series. This replaces
  * calling the tree once per day for per-campaign daily trends.
  *
+ * **Deleted objects stay in the tree.** Deleting an ad or a campaign is a soft delete: the Ad
+ * documents move to `status: cancelled` and are kept indefinitely, so their historical spend
+ * still counts toward the metrics of any date range they fall in. There is no pruning job and
+ * no retention window. Filter on `status` if your view should hide them, but do that after
+ * reading the totals, not before.
+ *
  */
 export const getAdTree = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAdTreeData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdTreeResponse, GetAdTreeError, ThrowOnError>({
@@ -7167,6 +7173,11 @@ export const getAdAnalytics = <ThrowOnError extends boolean = false>(options: Op
  * - LinkedIn (linkedinads): the campaign's Dynamic UTM `dynamicValueParameters` + `customValueParameters`.
  * Returns 405 for platforms without a click-URL tracking surface (TikTok, X, Pinterest).
  *
+ * **Not pixels.** Despite the shared path segment, this endpoint has nothing to do with
+ * measurement tags. For an ad account's pixels use
+ * `GET /v1/accounts/{accountId}/tracking-tags?adAccountId=act_...` (Meta Pixels, with `kind`
+ * and `ownerAdAccountId`) or `GET /v1/accounts/{accountId}/conversion-destinations`.
+ *
  */
 export const getAdTrackingTags = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetAdTrackingTagsData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetAdTrackingTagsResponse, GetAdTrackingTagsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -644,7 +644,7 @@ export type AdTreeAdSet = {
         page_id?: string;
     } | null;
     /**
-     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation (core fields like _id, name, platform, status, budget, metrics, creative, goal are included; targeting and schedule may be absent). When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
+     * Individual ads within this ad set (capped at 100). Returns a subset of Ad fields from the aggregation: `_id`, `name`, `platform`, `status`, `configuredStatus`, `reviewStatus`, `budget`, `metrics`, `creative`, `goal` and the `platform*` ids are always included; `targeting` and `schedule` may be absent. `configuredStatus` (the ad's own on/off toggle) and `reviewStatus` (the platform's review verdict) are part of this contract, not incidental: a rejected ad is only distinguishable from a healthy one through `reviewStatus`. When `timeIncrement=1&dailyLevel=ad`, each entry also carries a `daily[]` array of `AdDailyMetrics`.
      */
     ads?: Array<Ad>;
     /**
@@ -28472,6 +28472,12 @@ export type CreateStandaloneAdData = {
             /**
              * Pixel ID. **Meta:** Facebook Pixel ID, required for `goal: conversions`.
              * **TikTok:** TikTok Pixel ID, required for `goal: conversions`.
+             * To discover the pixels an ad account can use, call
+             * `GET /v1/accounts/{accountId}/tracking-tags?adAccountId=act_...` (each entry
+             * carries `kind` and `ownerAdAccountId`), or
+             * `GET /v1/accounts/{accountId}/conversion-destinations`. Note this is a
+             * different resource from `GET /v1/ads/{adId}/tracking-tags`, which reads an
+             * ad's click-URL params (`url_tags`), not pixels.
              *
              */
             pixelId?: string;