upload-post 2.14.0 → 2.15.0

package/README.md

@@ -183,6 +183,14 @@ await client.editScheduled('job-id', {
   timezone: 'America/New_York',
 });
 
+// Fix the text of a pending post in place (only the platforms listed change)
+await client.editScheduled('job-id', {
+  platformContent: {
+    instagram: { caption: 'New Instagram caption' },
+    tiktok: { caption: 'New TikTok caption' },
+  },
+});
+
 // Cancel a scheduled post
 await client.cancelScheduled('job-id');
 ```
@@ -648,7 +656,7 @@ for those options.
 - `facebookPageId` - Facebook Page ID (required)
 - `facebookVideoState` - PUBLISHED, DRAFT
 - `facebookMediaType` - REELS, STORIES, VIDEO (VIDEO for normal page videos with no 9:16 restriction)
-- `thumbnailUrl` - URL for custom video thumbnail (only when facebookMediaType is VIDEO)
+- `thumbnailUrl` - URL for custom video cover (generic field, also read by X, YouTube and LinkedIn; on Facebook only when facebookMediaType is VIDEO)
 - `facebookLinkUrl` - URL for text posts
 - `facebookAltText` - Alt text per photo
 - `facebookPlaceId` - Place ID
@@ -686,6 +694,8 @@ for those options.
 - `xAltText` - Alt text (≤1000 chars)
 - `xSubtitles` / `xSubtitlesUrl` / `xSubtitlesLanguage` / `xSubtitlesName` - Video captions
 - `xPaidPartnership` - Paid partnership label
+- `madeWithAi` - Disclose AI-generated media on X (`made_with_ai`; alias `isAiGenerated`)
+- `thumbnailUrl` - Custom video cover (generic field; applied by X as the post's preview image)
 - `xArticleTitle` / `xArticleBody` / `xArticleContentState` / `xArticleDraft` / `xArticleCoverMedia` - X Articles (Premium)
 
 ### Threads

package/index.d.ts

@@ -389,7 +389,7 @@ declare module 'upload-post' {
     facebookVideoState?: FacebookVideoState;
     /** Media type */
     facebookMediaType?: FacebookMediaType;
-    /** Thumbnail URL for normal page videos (only when facebookMediaType is 'VIDEO') */
+    /** Custom video cover URL. Generic API field: X, YouTube, LinkedIn and Facebook (only when facebookMediaType is 'VIDEO') read it */
     thumbnailUrl?: string;
     /** Facebook Place ID */
     facebookPlaceId?: string;
@@ -517,6 +517,12 @@ declare module 'upload-post' {
     xThreadImageLayout?: string;
     /** Alt text (≤1000 chars). String for video; string, list or `x_alt_text[]` for photos */
     xAltText?: string | string[];
+    /** Disclose that the post contains AI-generated media (X `made_with_ai`). Alias: isAiGenerated */
+    madeWithAi?: boolean;
+    /** Same as madeWithAi */
+    xMadeWithAi?: boolean;
+    /** Cross-platform alias of madeWithAi (API `is_ai_generated`) */
+    isAiGenerated?: boolean;
     /** Public URL of a .srt file (≤1 MB) */
     xSubtitlesUrl?: string;
     /** Inline SRT text, or a URL if the value starts with http(s) */
@@ -1406,7 +1412,18 @@ declare module 'upload-post' {
      * @param jobId - Scheduled job ID
      * @param options - Edit options
      */
-    editScheduled(jobId: string, options: { scheduledDate?: string; timezone?: string }): Promise<{ success: boolean }>;
+    editScheduled(jobId: string, options: {
+        scheduledDate?: string;
+        timezone?: string;
+        /** New title for every platform */
+        title?: string;
+        /** New caption/description for every platform */
+        caption?: string;
+        /** Alias of caption */
+        description?: string;
+        /** Per-platform text; only the platforms listed are touched */
+        platformContent?: Record<string, { title?: string; caption?: string }>;
+    }): Promise<{ success: boolean }>;
 
     // User Management
     /**

package/index.js

@@ -492,6 +492,8 @@ export class UploadPost {
       this._appendField(form, 'x_subtitles', this._pick(options, 'xSubtitles', 'x_subtitles'));
       this._appendField(form, 'x_subtitles_language', this._pick(options, 'xSubtitlesLanguage', 'x_subtitles_language'));
       this._appendField(form, 'x_subtitles_name', this._pick(options, 'xSubtitlesName', 'x_subtitles_name'));
+      // AI-media disclosure (X "made_with_ai"); is_ai_generated is the cross-platform alias.
+      this._appendField(form, 'made_with_ai', this._pick(options, 'xMadeWithAi', 'madeWithAi', 'made_with_ai', 'isAiGenerated', 'is_ai_generated'));
     } else {
       if (options.xPostUrl) form.append('post_url', options.xPostUrl);
       if (options.xCardUri) form.append('card_uri', options.xCardUri);
@@ -902,6 +904,14 @@ export class UploadPost {
     if (platforms.includes('google_business')) this._addGoogleBusinessParams(form, options);
     this._addCredentialPlatformParams(form, options);
 
+    // thumbnail_url is one generic API field, read by X, YouTube, LinkedIn and Facebook.
+    // The Facebook and YouTube helpers already send it for their platform; send it once
+    // here for the rest (X since 2.15.0) without duplicating the field.
+    const cover = this._pick(options, 'thumbnailUrl', 'thumbnail_url');
+    const coverAlreadySent = (platforms.includes('facebook') && cover)
+      || (platforms.includes('youtube') && options.youtubeThumbnailUrl);
+    if (cover && !coverAlreadySent) form.append('thumbnail_url', cover);
+
     return this._request('/upload', 'POST', form, true, this._idempotencyHeaders(options));
   }
 
@@ -1409,12 +1419,22 @@ export class UploadPost {
    * @param {Object} options - Edit options
    * @param {string} [options.scheduledDate] - New scheduled date (ISO 8601)
    * @param {string} [options.timezone] - New timezone
+   * @param {string} [options.title] - New title for every platform
+   * @param {string} [options.caption] - New caption/description for every platform
+   * @param {string} [options.description] - Alias of caption
+   * @param {Object} [options.platformContent] - Per-platform text, e.g.
+   *   { instagram: { caption: '...' }, tiktok: { caption: '...' }, youtube: { title: '...' } }.
+   *   Only the platforms listed are touched.
    * @returns {Promise<Object>} Edit result
    */
   async editScheduled(jobId, options) {
     const body = {};
     if (options.scheduledDate) body.scheduled_date = options.scheduledDate;
     if (options.timezone) body.timezone = options.timezone;
+    if (options.title !== undefined) body.title = options.title;
+    if (options.caption !== undefined) body.caption = options.caption;
+    else if (options.description !== undefined) body.description = options.description;
+    if (options.platformContent) body.platform_content = options.platformContent;
     return this._request(`/uploadposts/schedule/${jobId}`, 'PATCH', body);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Official client library for Upload-Post API - Cross-platform social media upload for TikTok, Instagram, YouTube, LinkedIn, Facebook, Pinterest, Threads, Reddit, Bluesky, and X (Twitter)",
   "main": "index.js",
   "types": "index.d.ts",