@publishq/sdk 0.0.2 → 0.0.3

package/dist/index.d.ts

@@ -468,6 +468,10 @@ type YouTubePlatformSpecificSettings = {
      * Playlist ID to add the video to after upload.
      */
     playlistId?: string;
+    /**
+     * ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`.
+     */
+    thumbnailMediaId?: string;
 };
 /**
  * TikTokPlatformSpecificSettings
@@ -663,6 +667,13 @@ type PostAccount = {
      * Error message from the platform if publishing failed for this account.
      */
     errorMessage?: string;
+    /**
+     * Present on a published account whose post set a custom thumbnail: whether the platform applied it, and if not, why. The post itself is live either way.
+     */
+    thumbnail?: {
+        status: 'APPLIED' | 'FAILED';
+        errorMessage?: string;
+    };
     failure?: PublishFailure & unknown;
     analytics?: PostAnalytics & unknown;
     postOverrides?: PostOverrides;
@@ -720,6 +731,10 @@ type PlatformSpecificSettings = {
      * Playlist ID to add the video to after upload.
      */
     playlistId?: string;
+    /**
+     * ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`.
+     */
+    thumbnailMediaId?: string;
 } | {
     /**
      * Who can view this post. The value must match one of the options returned by the TikTok creator_info/query endpoint for the target account.
@@ -925,7 +940,7 @@ type CreatePostAccount = {
     platformSpecificSettings?: PlatformSpecificSettings & unknown;
 };
 /**
- * Update a draft or scheduled post. Published and publishing posts cannot be updated. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media.
+ * Update a draft or scheduled post. Published and publishing posts cannot be updated. Only the fields you send change; everything you leave out keeps its current value. To remove an account setting, or an account's own text, media or thumbnail timestamp, send it as null. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media. The post that results from the update is validated as a whole before anything is saved.
  */
 type UpdatePostRequest = {
     /**
@@ -945,14 +960,39 @@ type UpdatePostRequest = {
      */
     thumbnailTimestamp?: number;
     /**
-     * Accounts whose content overrides or platform-specific settings should be updated, plus any additional connected accounts to add to the post. Existing accounts omitted from this array remain unchanged and must be removed through the account-specific delete endpoint.
+     * Accounts to change, plus any connected accounts to add to the post. For an account already in the post, only the fields you send change: omitted fields keep their current value and a field sent as null is removed. Existing accounts left out of this array stay unchanged; remove an account through the account-specific delete endpoint.
      */
-    accounts?: Array<CreatePostAccount>;
+    accounts?: Array<UpdatePostAccount>;
     /**
      * Publish an existing draft immediately. Cannot be combined with scheduledAt.
      */
     publishNow?: boolean;
 };
+type UpdatePostAccount = {
+    /**
+     * ID of a connected social account to post to.
+     */
+    accountId: string;
+    postOverrides?: UpdatePostOverrides;
+    platformSpecificSettings?: PlatformSpecificSettings & unknown;
+};
+/**
+ * Override the post-level content, media or thumbnail timestamp for this specific account.
+ */
+type UpdatePostOverrides = {
+    /**
+     * Custom text for this account. Omit it to keep the current text, or send null to drop the custom text so the account uses the post-level content again.
+     */
+    content?: string | null;
+    /**
+     * Media for this account only, up to 35, replacing what it has now. Omit it to keep the account's media, or send null so the account uses the post-level media again. Replacing it resets the account's thumbnail timestamp unless you send one too.
+     */
+    mediaIds?: Array<string> | null;
+    /**
+     * Video thumbnail timestamp in milliseconds for this account. Applies to Instagram and TikTok. Omit it to keep the current one, or send null to use the post's own.
+     */
+    thumbnailTimestamp?: number | null;
+};
 type SuccessMessage = {
     deleted: true;
     id: string;
@@ -2056,6 +2096,7 @@ declare const zYouTubePlatformSpecificSettings: z.ZodMiniObject<{
     tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
 }, z.z.core.$strip>;
 /**
  * TikTokPlatformSpecificSettings
@@ -2204,6 +2245,7 @@ declare const zPlatformSpecificSettings: z.ZodMiniUnion<readonly [z.ZodMiniObjec
     tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
 }, z.z.core.$strip>, z.ZodMiniObject<{
     privacyLevel: z.ZodMiniEnum<{
         PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2284,6 +2326,13 @@ declare const zPostAccount: z.ZodMiniObject<{
     externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
     publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
     errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+        status: z.ZodMiniEnum<{
+            FAILED: "FAILED";
+            APPLIED: "APPLIED";
+        }>;
+        errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.z.core.$strip>>;
     failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
         kind: z.ZodMiniEnum<{
             RECONNECT: "RECONNECT";
@@ -2341,6 +2390,7 @@ declare const zPostAccount: z.ZodMiniObject<{
         tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
         embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
         playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
     }, z.z.core.$strip>, z.ZodMiniObject<{
         privacyLevel: z.ZodMiniEnum<{
             PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2442,6 +2492,13 @@ declare const zPost: z.ZodMiniObject<{
         externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
         publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
         errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                FAILED: "FAILED";
+                APPLIED: "APPLIED";
+            }>;
+            errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.z.core.$strip>>;
         failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
             kind: z.ZodMiniEnum<{
                 RECONNECT: "RECONNECT";
@@ -2499,6 +2556,7 @@ declare const zPost: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2602,6 +2660,13 @@ declare const zPostsResponse: z.ZodMiniObject<{
             externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
             publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
             errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+                status: z.ZodMiniEnum<{
+                    FAILED: "FAILED";
+                    APPLIED: "APPLIED";
+                }>;
+                errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.z.core.$strip>>;
             failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
                 kind: z.ZodMiniEnum<{
                     RECONNECT: "RECONNECT";
@@ -2659,6 +2724,7 @@ declare const zPostsResponse: z.ZodMiniObject<{
                 tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
                 embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                 playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
             }, z.z.core.$strip>, z.ZodMiniObject<{
                 privacyLevel: z.ZodMiniEnum<{
                     PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2763,6 +2829,7 @@ declare const zCreatePostAccount: z.ZodMiniObject<{
         tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
         embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
         playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
     }, z.z.core.$strip>, z.ZodMiniObject<{
         privacyLevel: z.ZodMiniEnum<{
             PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2864,6 +2931,7 @@ declare const zCreatePostRequest: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -2926,7 +2994,110 @@ declare const zCreatePostRequest: z.ZodMiniObject<{
     publishNow: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
 }, z.z.core.$strip>;
 /**
- * Update a draft or scheduled post. Published and publishing posts cannot be updated. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media.
+ * Override the post-level content, media or thumbnail timestamp for this specific account.
+ */
+declare const zUpdatePostOverrides: z.ZodMiniObject<{
+    content: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+    mediaIds: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniUUID>>>;
+    thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumberFormat>>;
+}, z.z.core.$strip>;
+declare const zUpdatePostAccount: z.ZodMiniObject<{
+    accountId: z.ZodMiniUUID;
+    postOverrides: z.ZodMiniOptional<z.ZodMiniObject<{
+        content: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        mediaIds: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniUUID>>>;
+        thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumberFormat>>;
+    }, z.z.core.$strip>>;
+    platformSpecificSettings: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        privacyStatus: z.ZodMiniOptional<z.ZodMiniEnum<{
+            public: "public";
+            unlisted: "unlisted";
+            private: "private";
+        }>>;
+        madeForKids: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        containsSyntheticMedia: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        categoryId: z.ZodMiniOptional<z.ZodMiniEnum<{
+            1: "1";
+            2: "2";
+            10: "10";
+            15: "15";
+            17: "17";
+            19: "19";
+            20: "20";
+            22: "22";
+            23: "23";
+            24: "24";
+            25: "25";
+            26: "26";
+            27: "27";
+            28: "28";
+            29: "29";
+        }>>;
+        tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        privacyLevel: z.ZodMiniEnum<{
+            PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
+            FOLLOWER_OF_CREATOR: "FOLLOWER_OF_CREATOR";
+            MUTUAL_FOLLOW_FRIENDS: "MUTUAL_FOLLOW_FRIENDS";
+            SELF_ONLY: "SELF_ONLY";
+        }>;
+        disableComment: z.ZodMiniBoolean<boolean>;
+        disableDuet: z.ZodMiniBoolean<boolean>;
+        disableStitch: z.ZodMiniBoolean<boolean>;
+        brandContentToggle: z.ZodMiniBoolean<boolean>;
+        brandOrganicToggle: z.ZodMiniBoolean<boolean>;
+        autoAddMusic: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        videoMadeWithAi: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        photoCoverIndex: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        contentType: z.ZodMiniOptional<z.ZodMiniEnum<{
+            story: "story";
+            reels: "reels";
+        }>>;
+        shareToFeed: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        trialParams: z.ZodMiniOptional<z.ZodMiniObject<{
+            graduationStrategy: z.ZodMiniEnum<{
+                MANUAL: "MANUAL";
+                SS_PERFORMANCE: "SS_PERFORMANCE";
+            }>;
+        }, z.z.core.$strip>>;
+        audioName: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        contentType: z.ZodMiniOptional<z.ZodMiniEnum<{
+            story: "story";
+        }>>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        topicTag: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        communityId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        shareWithFollowers: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        forSuperFollowersOnly: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        replySettings: z.ZodMiniOptional<z.ZodMiniEnum<{
+            following: "following";
+            mentionedUsers: "mentionedUsers";
+            subscribers: "subscribers";
+            verified: "verified";
+        }>>;
+        quoteTweetId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        replyToTweetId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        poll: z.ZodMiniOptional<z.ZodMiniObject<{
+            options: z.ZodMiniArray<z.ZodMiniString<string>>;
+            durationMinutes: z.ZodMiniNumberFormat;
+        }, z.z.core.$strip>>;
+    }, z.z.core.$strip>, z.ZodMiniObject<{
+        visibility: z.ZodMiniOptional<z.ZodMiniEnum<{
+            CONNECTIONS: "CONNECTIONS";
+            PUBLIC: "PUBLIC";
+        }>>;
+    }, z.z.core.$strip>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniNever>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>]>, z.ZodMiniUnknown>>;
+}, z.z.core.$strip>;
+/**
+ * Update a draft or scheduled post. Published and publishing posts cannot be updated. Only the fields you send change; everything you leave out keeps its current value. To remove an account setting, or an account's own text, media or thumbnail timestamp, send it as null. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media. The post that results from the update is validated as a whole before anything is saved.
  */
 declare const zUpdatePostRequest: z.ZodMiniObject<{
     content: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -2935,11 +3106,11 @@ declare const zUpdatePostRequest: z.ZodMiniObject<{
     thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
     accounts: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
         accountId: z.ZodMiniUUID;
-        postOverrides: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
-            content: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
-            mediaIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUUID>>;
-        }, z.z.core.$strip>, z.ZodMiniUnknown>>;
+        postOverrides: z.ZodMiniOptional<z.ZodMiniObject<{
+            content: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+            mediaIds: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniUUID>>>;
+            thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumberFormat>>;
+        }, z.z.core.$strip>>;
         platformSpecificSettings: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
             description: z.ZodMiniOptional<z.ZodMiniString<string>>;
             privacyStatus: z.ZodMiniOptional<z.ZodMiniEnum<{
@@ -2969,6 +3140,7 @@ declare const zUpdatePostRequest: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3234,6 +3406,13 @@ declare const zListPostsResponse: z.ZodMiniObject<{
             externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
             publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
             errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+                status: z.ZodMiniEnum<{
+                    FAILED: "FAILED";
+                    APPLIED: "APPLIED";
+                }>;
+                errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            }, z.z.core.$strip>>;
             failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
                 kind: z.ZodMiniEnum<{
                     RECONNECT: "RECONNECT";
@@ -3291,6 +3470,7 @@ declare const zListPostsResponse: z.ZodMiniObject<{
                 tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
                 embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
                 playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+                thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
             }, z.z.core.$strip>, z.ZodMiniObject<{
                 privacyLevel: z.ZodMiniEnum<{
                     PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3399,6 +3579,7 @@ declare const zCreatePostBody: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3506,6 +3687,13 @@ declare const zCreatePostResponse: z.ZodMiniObject<{
         externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
         publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
         errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                FAILED: "FAILED";
+                APPLIED: "APPLIED";
+            }>;
+            errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.z.core.$strip>>;
         failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
             kind: z.ZodMiniEnum<{
                 RECONNECT: "RECONNECT";
@@ -3563,6 +3751,7 @@ declare const zCreatePostResponse: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3678,6 +3867,13 @@ declare const zGetPostResponse: z.ZodMiniObject<{
         externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
         publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
         errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                FAILED: "FAILED";
+                APPLIED: "APPLIED";
+            }>;
+            errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.z.core.$strip>>;
         failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
             kind: z.ZodMiniEnum<{
                 RECONNECT: "RECONNECT";
@@ -3735,6 +3931,7 @@ declare const zGetPostResponse: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3801,11 +3998,11 @@ declare const zUpdatePostBody: z.ZodMiniObject<{
     thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
     accounts: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
         accountId: z.ZodMiniUUID;
-        postOverrides: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
-            content: z.ZodMiniOptional<z.ZodMiniString<string>>;
-            thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNumberFormat>;
-            mediaIds: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUUID>>;
-        }, z.z.core.$strip>, z.ZodMiniUnknown>>;
+        postOverrides: z.ZodMiniOptional<z.ZodMiniObject<{
+            content: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+            mediaIds: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniArray<z.ZodMiniUUID>>>;
+            thumbnailTimestamp: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniNumberFormat>>;
+        }, z.z.core.$strip>>;
         platformSpecificSettings: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniUnion<readonly [z.ZodMiniObject<{
             description: z.ZodMiniOptional<z.ZodMiniString<string>>;
             privacyStatus: z.ZodMiniOptional<z.ZodMiniEnum<{
@@ -3835,6 +4032,7 @@ declare const zUpdatePostBody: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -3944,6 +4142,13 @@ declare const zUpdatePostResponse: z.ZodMiniObject<{
         externalUrl: z.ZodMiniOptional<z.ZodMiniURL>;
         publishedAt: z.ZodMiniOptional<z.z.iso.ZodMiniISODateTime>;
         errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        thumbnail: z.ZodMiniOptional<z.ZodMiniObject<{
+            status: z.ZodMiniEnum<{
+                FAILED: "FAILED";
+                APPLIED: "APPLIED";
+            }>;
+            errorMessage: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.z.core.$strip>>;
         failure: z.ZodMiniOptional<z.ZodMiniIntersection<z.ZodMiniObject<{
             kind: z.ZodMiniEnum<{
                 RECONNECT: "RECONNECT";
@@ -4001,6 +4206,7 @@ declare const zUpdatePostResponse: z.ZodMiniObject<{
             tags: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
             embeddable: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
             playlistId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            thumbnailMediaId: z.ZodMiniOptional<z.ZodMiniUUID>;
         }, z.z.core.$strip>, z.ZodMiniObject<{
             privacyLevel: z.ZodMiniEnum<{
                 PUBLIC_TO_EVERYONE: "PUBLIC_TO_EVERYONE";
@@ -4552,4 +4758,4 @@ declare function createMediaNamespace(client: Client): {
     }>;
 };
 
-export { type Account, Accounts, type AccountsResponse, type ApiError, type ApiErrorCode, type ApiKeyScope, type BlueskyPlatformSpecificSettings, type ClientOptions, type CompleteMediaUploadData, type CompleteMediaUploadError, type CompleteMediaUploadErrors, type CompleteMediaUploadResponse, type CompleteMediaUploadResponses, type CreateMediaUploadData, type CreateMediaUploadError, type CreateMediaUploadErrors, type CreateMediaUploadRequest, type CreateMediaUploadResponse, type CreateMediaUploadResponses, type CreatePostAccount, type CreatePostData, type CreatePostError, type CreatePostErrors, type CreatePostRequest, type CreatePostResponse, type CreatePostResponses, type CreateWorkspaceData, type CreateWorkspaceError, type CreateWorkspaceErrors, type CreateWorkspaceRequest, type CreateWorkspaceResponse, type CreateWorkspaceResponses, type DeletePostData, type DeletePostError, type DeletePostErrors, type DeletePostResponse, type DeletePostResponses, type FacebookPlatformSpecificSettings, type GetMediaData, type GetMediaError, type GetMediaErrors, type GetMediaResponse, type GetMediaResponses, type GetPostData, type GetPostError, type GetPostErrors, type GetPostResponse, type GetPostResponses, type GetTikTokCreatorInfoData, type GetTikTokCreatorInfoError, type GetTikTokCreatorInfoErrors, type GetTikTokCreatorInfoResponse, type GetTikTokCreatorInfoResponses, type GetWorkspaceData, type GetWorkspaceError, type GetWorkspaceErrors, type GetWorkspaceResponse, type GetWorkspaceResponses, type InstagramPlatformSpecificSettings, type InstagramTrialParams, type LinkedInPlatformSpecificSettings, type ListAccountsData, type ListAccountsError, type ListAccountsErrors, type ListAccountsResponse, type ListAccountsResponses, type ListMediaData, type ListMediaError, type ListMediaErrors, type ListMediaResponse, type ListMediaResponses, type ListPostsData, type ListPostsError, type ListPostsErrors, type ListPostsResponse, type ListPostsResponses, type ListWorkspacesData, type ListWorkspacesError, type ListWorkspacesErrors, type ListWorkspacesResponse, type ListWorkspacesResponses, type Media$1 as Media, Media as Media2, type MediaListResponse, type MediaSource, type MediaType, type MediaUpload, type Options, type Pagination, type PlatformSpecificSettings, type Post, type PostAccount, type PostAnalytics, type PostOverrides, type PostSource, type PostStatus, Posts, type PostsResponse, type PublishFailure, PublishQ, type PublishQOptions, type RemovePostAccountData, type RemovePostAccountError, type RemovePostAccountErrors, type RemovePostAccountResponse, type RemovePostAccountResponses, STORAGE_UPLOAD_THRESHOLD_BYTES, type SocialPlatform, type SuccessMessage, type ThreadsPlatformSpecificSettings, type TikTokCreatorInfoResponse, type TikTokPlatformSpecificSettings, type TwitterPlatformSpecificSettings, type UpdatePostData, type UpdatePostError, type UpdatePostErrors, type UpdatePostRequest, type UpdatePostResponse, type UpdatePostResponses, type UploadMediaData, type UploadMediaError, type UploadMediaErrors, type UploadMediaRequest, type UploadMediaResponse, type UploadMediaResponses, type Workspace, Workspaces, type WorkspacesResponse, type YouTubePlatformSpecificSettings, PublishQ as default, withInferredContentType, zAccount, zAccountsResponse, zApiError, zApiErrorCode, zApiKeyScope, zBlueskyPlatformSpecificSettings, zCompleteMediaUploadPath, zCompleteMediaUploadResponse, zCreateMediaUploadBody, zCreateMediaUploadRequest, zCreateMediaUploadResponse, zCreatePostAccount, zCreatePostBody, zCreatePostRequest, zCreatePostResponse, zCreateWorkspaceBody, zCreateWorkspaceRequest, zCreateWorkspaceResponse, zDeletePostPath, zDeletePostResponse, zFacebookPlatformSpecificSettings, zGetMediaPath, zGetMediaResponse, zGetPostPath, zGetPostResponse, zGetTikTokCreatorInfoPath, zGetTikTokCreatorInfoResponse, zGetWorkspacePath, zGetWorkspaceResponse, zInstagramPlatformSpecificSettings, zInstagramTrialParams, zLinkedInPlatformSpecificSettings, zListAccountsQuery, zListAccountsResponse, zListMediaQuery, zListMediaResponse, zListPostsQuery, zListPostsResponse, zListWorkspacesResponse, zMedia, zMediaListResponse, zMediaSource, zMediaType, zMediaUpload, zPagination, zPlatformSpecificSettings, zPost, zPostAccount, zPostAnalytics, zPostOverrides, zPostSource, zPostStatus, zPostsResponse, zPublishFailure, zRemovePostAccountPath, zRemovePostAccountResponse, zSocialPlatform, zSuccessMessage, zThreadsPlatformSpecificSettings, zTikTokCreatorInfoResponse, zTikTokPlatformSpecificSettings, zTwitterPlatformSpecificSettings, zUpdatePostBody, zUpdatePostPath, zUpdatePostRequest, zUpdatePostResponse, zUploadMediaBody, zUploadMediaRequest, zUploadMediaResponse, zWorkspace, zWorkspacesResponse, zYouTubePlatformSpecificSettings };
+export { type Account, Accounts, type AccountsResponse, type ApiError, type ApiErrorCode, type ApiKeyScope, type BlueskyPlatformSpecificSettings, type ClientOptions, type CompleteMediaUploadData, type CompleteMediaUploadError, type CompleteMediaUploadErrors, type CompleteMediaUploadResponse, type CompleteMediaUploadResponses, type CreateMediaUploadData, type CreateMediaUploadError, type CreateMediaUploadErrors, type CreateMediaUploadRequest, type CreateMediaUploadResponse, type CreateMediaUploadResponses, type CreatePostAccount, type CreatePostData, type CreatePostError, type CreatePostErrors, type CreatePostRequest, type CreatePostResponse, type CreatePostResponses, type CreateWorkspaceData, type CreateWorkspaceError, type CreateWorkspaceErrors, type CreateWorkspaceRequest, type CreateWorkspaceResponse, type CreateWorkspaceResponses, type DeletePostData, type DeletePostError, type DeletePostErrors, type DeletePostResponse, type DeletePostResponses, type FacebookPlatformSpecificSettings, type GetMediaData, type GetMediaError, type GetMediaErrors, type GetMediaResponse, type GetMediaResponses, type GetPostData, type GetPostError, type GetPostErrors, type GetPostResponse, type GetPostResponses, type GetTikTokCreatorInfoData, type GetTikTokCreatorInfoError, type GetTikTokCreatorInfoErrors, type GetTikTokCreatorInfoResponse, type GetTikTokCreatorInfoResponses, type GetWorkspaceData, type GetWorkspaceError, type GetWorkspaceErrors, type GetWorkspaceResponse, type GetWorkspaceResponses, type InstagramPlatformSpecificSettings, type InstagramTrialParams, type LinkedInPlatformSpecificSettings, type ListAccountsData, type ListAccountsError, type ListAccountsErrors, type ListAccountsResponse, type ListAccountsResponses, type ListMediaData, type ListMediaError, type ListMediaErrors, type ListMediaResponse, type ListMediaResponses, type ListPostsData, type ListPostsError, type ListPostsErrors, type ListPostsResponse, type ListPostsResponses, type ListWorkspacesData, type ListWorkspacesError, type ListWorkspacesErrors, type ListWorkspacesResponse, type ListWorkspacesResponses, type Media$1 as Media, Media as Media2, type MediaListResponse, type MediaSource, type MediaType, type MediaUpload, type Options, type Pagination, type PlatformSpecificSettings, type Post, type PostAccount, type PostAnalytics, type PostOverrides, type PostSource, type PostStatus, Posts, type PostsResponse, type PublishFailure, PublishQ, type PublishQOptions, type RemovePostAccountData, type RemovePostAccountError, type RemovePostAccountErrors, type RemovePostAccountResponse, type RemovePostAccountResponses, STORAGE_UPLOAD_THRESHOLD_BYTES, type SocialPlatform, type SuccessMessage, type ThreadsPlatformSpecificSettings, type TikTokCreatorInfoResponse, type TikTokPlatformSpecificSettings, type TwitterPlatformSpecificSettings, type UpdatePostAccount, type UpdatePostData, type UpdatePostError, type UpdatePostErrors, type UpdatePostOverrides, type UpdatePostRequest, type UpdatePostResponse, type UpdatePostResponses, type UploadMediaData, type UploadMediaError, type UploadMediaErrors, type UploadMediaRequest, type UploadMediaResponse, type UploadMediaResponses, type Workspace, Workspaces, type WorkspacesResponse, type YouTubePlatformSpecificSettings, PublishQ as default, withInferredContentType, zAccount, zAccountsResponse, zApiError, zApiErrorCode, zApiKeyScope, zBlueskyPlatformSpecificSettings, zCompleteMediaUploadPath, zCompleteMediaUploadResponse, zCreateMediaUploadBody, zCreateMediaUploadRequest, zCreateMediaUploadResponse, zCreatePostAccount, zCreatePostBody, zCreatePostRequest, zCreatePostResponse, zCreateWorkspaceBody, zCreateWorkspaceRequest, zCreateWorkspaceResponse, zDeletePostPath, zDeletePostResponse, zFacebookPlatformSpecificSettings, zGetMediaPath, zGetMediaResponse, zGetPostPath, zGetPostResponse, zGetTikTokCreatorInfoPath, zGetTikTokCreatorInfoResponse, zGetWorkspacePath, zGetWorkspaceResponse, zInstagramPlatformSpecificSettings, zInstagramTrialParams, zLinkedInPlatformSpecificSettings, zListAccountsQuery, zListAccountsResponse, zListMediaQuery, zListMediaResponse, zListPostsQuery, zListPostsResponse, zListWorkspacesResponse, zMedia, zMediaListResponse, zMediaSource, zMediaType, zMediaUpload, zPagination, zPlatformSpecificSettings, zPost, zPostAccount, zPostAnalytics, zPostOverrides, zPostSource, zPostStatus, zPostsResponse, zPublishFailure, zRemovePostAccountPath, zRemovePostAccountResponse, zSocialPlatform, zSuccessMessage, zThreadsPlatformSpecificSettings, zTikTokCreatorInfoResponse, zTikTokPlatformSpecificSettings, zTwitterPlatformSpecificSettings, zUpdatePostAccount, zUpdatePostBody, zUpdatePostOverrides, zUpdatePostPath, zUpdatePostRequest, zUpdatePostResponse, zUploadMediaBody, zUploadMediaRequest, zUploadMediaResponse, zWorkspace, zWorkspacesResponse, zYouTubePlatformSpecificSettings };

package/dist/index.js

@@ -1199,6 +1199,9 @@ var zYouTubePlatformSpecificSettings = z.object({
   })),
   playlistId: z.optional(z.string().register(z.globalRegistry, {
     description: "Playlist ID to add the video to after upload."
+  })),
+  thumbnailMediaId: z.optional(z.uuid().register(z.globalRegistry, {
+    description: "ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`."
   }))
 }).register(z.globalRegistry, {
   description: "YouTube-specific upload settings, such as description and privacy."
@@ -1416,6 +1419,9 @@ var zPlatformSpecificSettings = z.union([
     })),
     playlistId: z.optional(z.string().register(z.globalRegistry, {
       description: "Playlist ID to add the video to after upload."
+    })),
+    thumbnailMediaId: z.optional(z.uuid().register(z.globalRegistry, {
+      description: "ID of an image in your media library to set as the custom thumbnail of this video. JPEG or PNG, up to 50MB; YouTube recommends 1280x720 (16:9). Upload the image with the media endpoints first. The thumbnail is set right after the video uploads. If YouTube refuses it (custom thumbnails need a verified channel), the video still publishes and `thumbnail` on the account says why. To replace it on a draft or scheduled post, update the account with the new id; to remove it, send `thumbnailMediaId: null`."
     }))
   }).register(z.globalRegistry, {
     description: "YouTube-specific upload settings, such as description and privacy."
@@ -1560,6 +1566,12 @@ var zPostAccount = z.object({
   errorMessage: z.optional(z.string().register(z.globalRegistry, {
     description: "Error message from the platform if publishing failed for this account."
   })),
+  thumbnail: z.optional(z.object({
+    status: z.enum(["APPLIED", "FAILED"]),
+    errorMessage: z.optional(z.string())
+  }).register(z.globalRegistry, {
+    description: "Present on a published account whose post set a custom thumbnail: whether the platform applied it, and if not, why. The post itself is live either way."
+  })),
   failure: z.optional(z.intersection(zPublishFailure, z.unknown().register(z.globalRegistry, {
     description: "The same failure read as an action: what happened and the one thing to do about it. Present whenever status is FAILED, including when the platform gave no reason. The wording is what the app and the failure email show, so a client does not have to interpret `errorMessage` itself."
   }))),
@@ -1637,6 +1649,22 @@ var zCreatePostRequest = z.object({
 }).register(z.globalRegistry, {
   description: "Create a post across one or more connected social accounts."
 });
+var zUpdatePostOverrides = z.object({
+  content: z.nullish(z.string()),
+  mediaIds: z.nullish(z.array(z.uuid()).check(z.maxLength(35))),
+  thumbnailTimestamp: z.nullish(z.int().check(z.gte(0)))
+}).register(z.globalRegistry, {
+  description: "Override the post-level content, media or thumbnail timestamp for this specific account."
+});
+var zUpdatePostAccount = z.object({
+  accountId: z.uuid().register(z.globalRegistry, {
+    description: "ID of a connected social account to post to."
+  }),
+  postOverrides: z.optional(zUpdatePostOverrides),
+  platformSpecificSettings: z.optional(z.intersection(zPlatformSpecificSettings, z.unknown().register(z.globalRegistry, {
+    description: "Platform-specific settings to change. Only the settings you send change, and every setting you leave out keeps its current value. Send a setting as null to remove it. Nested objects merge the same way (JSON Merge Patch, RFC 7396). The resulting settings must still be valid for the platform, so a required setting cannot be removed."
+  })))
+});
 var zUpdatePostRequest = z.object({
   content: z.optional(z.string().register(z.globalRegistry, {
     description: "New shared text content for the post."
@@ -1650,14 +1678,14 @@ var zUpdatePostRequest = z.object({
   thumbnailTimestamp: z.optional(z.int().check(z.gte(0)).register(z.globalRegistry, {
     description: "New video thumbnail timestamp in milliseconds for Instagram and TikTok media. Does not change which media files are attached. Combine with mediaIds if you want to replace media and set the new thumbnail timestamp in the same request."
   })),
-  accounts: z.optional(z.array(zCreatePostAccount).check(z.minLength(1)).register(z.globalRegistry, {
-    description: "Accounts whose content overrides or platform-specific settings should be updated, plus any additional connected accounts to add to the post. Existing accounts omitted from this array remain unchanged and must be removed through the account-specific delete endpoint."
+  accounts: z.optional(z.array(zUpdatePostAccount).check(z.minLength(1)).register(z.globalRegistry, {
+    description: "Accounts to change, plus any connected accounts to add to the post. For an account already in the post, only the fields you send change: omitted fields keep their current value and a field sent as null is removed. Existing accounts left out of this array stay unchanged; remove an account through the account-specific delete endpoint."
   })),
   publishNow: z.optional(z.boolean().register(z.globalRegistry, {
     description: "Publish an existing draft immediately. Cannot be combined with scheduledAt."
   }))
 }).register(z.globalRegistry, {
-  description: "Update a draft or scheduled post. Published and publishing posts cannot be updated. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media."
+  description: "Update a draft or scheduled post. Published and publishing posts cannot be updated. Only the fields you send change; everything you leave out keeps its current value. To remove an account setting, or an account's own text, media or thumbnail timestamp, send it as null. Media behavior is explicit: omit mediaIds to keep existing media unchanged, provide mediaIds to replace all current media, or provide an empty mediaIds array to remove all media. The post that results from the update is validated as a whole before anything is saved."
 });
 var zSuccessMessage = z.object({
   deleted: z.literal(true),
@@ -2154,7 +2182,9 @@ export {
   zTikTokCreatorInfoResponse,
   zTikTokPlatformSpecificSettings,
   zTwitterPlatformSpecificSettings,
+  zUpdatePostAccount,
   zUpdatePostBody,
+  zUpdatePostOverrides,
   zUpdatePostPath,
   zUpdatePostRequest,
   zUpdatePostResponse,