@getlatedev/node 0.2.1296 → 0.2.1298

package/src/generated/types.gen.ts

@@ -1,5 +1,13 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
+export type AccountCursorPagination = {
+    limit: number;
+    /**
+     * Opaque cursor for the next page; pass it back as `cursor`. Null on the last page.
+     */
+    nextCursor: (string) | null;
+};
+
 export type AccountsListResponse = {
     accounts: Array<SocialAccount>;
     /**
@@ -7,9 +15,9 @@ export type AccountsListResponse = {
      */
     hasAnalyticsAccess: boolean;
     /**
-     * Only present when page/limit params are provided
+     * Present on a paginated request: `{ page, limit, total, pages }` with page and limit, `{ limit, nextCursor }` with cursor paging (limit alone or cursor).
      */
-    pagination?: Pagination;
+    pagination?: (Pagination | AccountCursorPagination);
     /**
      * Only with profileIds and perProfile. Accounts matching the filters per profile ID; a profile with none is absent.
      */
@@ -6763,6 +6771,10 @@ export type FollowerStatsResponse = {
         to?: string;
     };
     granularity?: string;
+    /**
+     * Only present when limit or cursor is sent.
+     */
+    pagination?: AccountCursorPagination;
 };
 
 export type FoodMenu = {
@@ -21290,6 +21302,10 @@ export type ListAccountsData = {
          * Only accounts of this kind. ads = ad accounts (Meta, Google, LinkedIn, Pinterest, TikTok, X, OpenAI, Reddit), communication = WhatsApp, Telegram, Discord, Slack and iMessage, blogs = Shopify and WordPress, crm = HubSpot, social = every other platform.
          */
         category?: 'social' | 'ads' | 'communication' | 'blogs' | 'crm';
+        /**
+         * Opaque cursor from a previous response's `pagination.nextCursor`; returns the next page of `limit` accounts (500 when limit is omitted). A cursor we cannot parse returns 400. Cannot be combined with page.
+         */
+        cursor?: string;
         /**
          * When true, leaves out accounts the dashboard does not show as connections: posting
          * accounts with `enabled: false` (ads accounts are always kept, whatever their `enabled`
@@ -21307,7 +21323,7 @@ export type ListAccountsData = {
         /**
          * When true, appends the shared WhatsApp sandbox account and the iMessage sandbox account
          * to the list when they are active, honouring `platform` but no other filter. Ignored on
-         * a paginated request (page/limit) and together with `perProfile`. Accepts `true` or
+         * a paginated request (page, limit or cursor) and together with `perProfile`. Accepts `true` or
          * `false` in any letter case; any other value returns 400.
          *
          */
@@ -21320,7 +21336,7 @@ export type ListAccountsData = {
          */
         includeStatusCounts?: boolean;
         /**
-         * Page size. Must be provided together with page; sending only one of the two returns 400.
+         * Page size. With page, an offset page; alone or with cursor, a cursor page.
          *
          */
         limit?: number;
@@ -21329,12 +21345,12 @@ export type ListAccountsData = {
          */
         order?: 'asc' | 'desc';
         /**
-         * Page number (1-based). Must be provided together with limit to enable server-side pagination; sending only one of the two returns 400. Omit both for all accounts.
+         * Page number (1-based) for offset paging. Requires limit; omit page, limit and cursor for all accounts.
          *
          */
         page?: number;
         /**
-         * Return a preview of each profile in profileIds: the newest account of every platform it has, topped up to at least N. Requires profileIds; cannot be combined with page and limit.
+         * Return a preview of each profile in profileIds: the newest account of every platform it has, topped up to at least N. Requires profileIds; cannot be combined with page, limit or cursor.
          */
         perProfile?: number;
         /**
@@ -21354,7 +21370,7 @@ export type ListAccountsData = {
          */
         search?: string;
         /**
-         * Sort a paginated listing (page/limit) by account name, platform, profile name, status (accounts needing a reconnect first when ascending) or connection date. Ties keep the default order: platform, then newest first.
+         * Sort an offset-paginated listing (page and limit) by account name, platform, profile name, status (accounts needing a reconnect first when ascending) or connection date. Ties keep the default order: platform, then newest first.
          */
         sort?: 'account' | 'platform' | 'profile' | 'status' | 'connected';
         /**
@@ -21375,6 +21391,10 @@ export type GetFollowerStatsData = {
          * Comma-separated list of account IDs (optional, defaults to all user's accounts)
          */
         accountIds?: string;
+        /**
+         * Opaque cursor from a previous response's `pagination.nextCursor`; returns the next page of `limit` accounts (25 when limit is omitted). A cursor we cannot parse returns 400.
+         */
+        cursor?: string;
         /**
          * Start date in YYYY-MM-DD format (defaults to 30 days ago)
          */
@@ -21383,6 +21403,10 @@ export type GetFollowerStatsData = {
          * Data aggregation level
          */
         granularity?: 'daily' | 'weekly' | 'monthly';
+        /**
+         * Accounts per page, ordered by account id. Send it to page through accounts; the response then carries `pagination.nextCursor`. Without limit or cursor every matching account is returned.
+         */
+        limit?: number;
         /**
          * Filter by profile ID
          */
@@ -53884,6 +53908,9 @@ export type AddUsersToAdAudienceData = {
 export type AddUsersToAdAudienceResponse = ({
     message?: string;
     numReceived?: number;
+    /**
+     * Rows the platform could not read. Returned on Meta only.
+     */
     numInvalid?: number;
 });
 
@@ -53891,6 +53918,43 @@ export type AddUsersToAdAudienceError = (unknown | ErrorResponse | {
     error?: string;
 });
 
+export type RemoveUsersFromAdAudienceData = {
+    body: {
+        users: Array<{
+            email?: string;
+            phone?: string;
+        }>;
+    };
+    path: {
+        /**
+         * The Zernio audience id (the id field of GET /v1/ads/audiences), not the platform segment id.
+         */
+        audienceId: string;
+    };
+};
+
+export type RemoveUsersFromAdAudienceResponse = ({
+    message?: string;
+    /**
+     * Rows Meta received.
+     */
+    numReceived?: number;
+    /**
+     * Rows Meta could not read.
+     */
+    numInvalid?: number;
+    /**
+     * A sample of the rows Meta could not read, passed through as Meta returns it. Empty when every row was valid.
+     */
+    invalidEntrySamples?: {
+        [key: string]: (string);
+    };
+});
+
+export type RemoveUsersFromAdAudienceError = (ErrorResponse | unknown | {
+    error?: string;
+});
+
 export type ReplaceAdAudienceCompaniesData = {
     body: {
         /**