upload-post 2.15.0 → 2.17.0

package/README.md

@@ -191,6 +191,14 @@ await client.editScheduled('job-id', {
   },
 });
 
+// Change any other option by its API form name (null removes it), schedule the
+// video natively on YouTube, or replace the Reels cover
+await client.editScheduled('job-id', {
+  fields: { privacyStatus: 'unlisted', disable_comment: true, instagram_first_comment: 'Link in bio' },
+  youtubePublishAt: '2026-11-01T09:00:00Z',
+  coverImageBase64: 'data:image/jpeg;base64,...', // or removeCover: true
+});
+
 // Cancel a scheduled post
 await client.cancelScheduled('job-id');
 ```
@@ -622,6 +630,8 @@ for those options.
 - `instagramLocationId` - Location ID
 - `instagramThumbOffset` - Thumbnail offset
 - `instagramAltText` - Alt text on photos (string or list, ≤1000 chars each)
+- `instagramShareMode` - Trial Reels: `TRIAL_REELS_SHARE_TO_FOLLOWERS_IF_LIKED` or `TRIAL_REELS_DONT_SHARE_TO_FOLLOWERS` (videos only)
+- `instagramIsAiGenerated` - AI-generated content label (sent as the generic `is_ai_generated`, which other platforms in the same post also read)
 
 ### YouTube
 - `youtubeTags` - Array or comma-separated tags
@@ -659,6 +669,7 @@ for those options.
 - `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
+- `facebookMediaType` on photos - POSTS (feed, default) or STORIES (Page photo story)
 - `facebookPlaceId` - Place ID
 - `facebookTargeting` / `facebookFeedTargeting` - Audience JSON
 - `facebookCallToAction` / `facebookChildAttachments` / `facebookMultiShareEndCard` - Link posts

package/index.d.ts

@@ -36,6 +36,8 @@ declare module 'upload-post' {
 
   /** Facebook media type */
   export type FacebookMediaType = 'REELS' | 'STORIES' | 'VIDEO';
+  export type FacebookPhotoMediaType = 'POSTS' | 'STORIES';
+  export type InstagramShareMode = 'TRIAL_REELS_SHARE_TO_FOLLOWERS_IF_LIKED' | 'TRIAL_REELS_DONT_SHARE_TO_FOLLOWERS';
 
   /** X (Twitter) reply settings */
   export type XReplySettings = 'everyone' | 'following' | 'mentionedUsers' | 'subscribers' | 'verified';
@@ -274,6 +276,10 @@ declare module 'upload-post' {
     instagramLocationId?: string;
     /** Thumbnail offset */
     instagramThumbOffset?: string;
+    /** Trial Reel: shown to non-followers first. Sent as share_mode */
+    instagramShareMode?: InstagramShareMode;
+    /** AI-generated content label. Sent as the generic is_ai_generated field */
+    instagramIsAiGenerated?: boolean;
   }
 
   export interface InstagramPhotoOptions {
@@ -287,6 +293,8 @@ declare module 'upload-post' {
     instagramLocationId?: string;
     /** Alt text: string (applied to every item) or list of strings, ≤1000 chars each */
     instagramAltText?: string | string[];
+    /** AI-generated content label. Sent as the generic is_ai_generated field */
+    instagramIsAiGenerated?: boolean;
   }
 
   // ==================== YouTube Options ====================
@@ -414,6 +422,8 @@ declare module 'upload-post' {
     facebookPageId?: string;
     /** Alt text per photo */
     facebookAltText?: string | string[];
+    /** POSTS (default) publishes to the feed, STORIES as a Page story */
+    facebookMediaType?: FacebookPhotoMediaType;
     /** Facebook Place ID */
     facebookPlaceId?: string;
     /** Geographic/age/language targeting */
@@ -968,6 +978,50 @@ declare module 'upload-post' {
     [key: string]: any;
   }
 
+  /** Body of PATCH /api/uploadposts/schedule/<job_id>. Every key is optional. */
+  export interface EditScheduledOptions {
+    /** New publish date (ISO 8601); must be in the future and within 1 year */
+    scheduledDate?: string;
+    /** IANA timezone `scheduledDate` is read in (default UTC) */
+    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 }>;
+    /**
+     * Any other editable upload option, keyed by its API form name
+     * (e.g. `privacyStatus`, `tags`, `disable_comment`, `instagram_first_comment`,
+     * `gbp_cta_url`). `null` removes the option; unknown or internal keys are ignored.
+     */
+    fields?: Record<string, string | number | boolean | string[] | null>;
+    /** Native YouTube scheduling (RFC3339), sent as `fields.youtube_publish_at`; `null` removes it */
+    youtubePublishAt?: string | null;
+    /** New cover image (Instagram / Facebook Reels) as base64 or a data URL */
+    coverImageBase64?: string;
+    /** File name of the new cover (default `cover.jpg`) */
+    coverFilename?: string;
+    /** MIME type of the new cover (default `image/jpeg`) */
+    coverContentType?: string;
+    /** Remove the custom cover */
+    removeCover?: boolean;
+  }
+
+  export interface EditScheduledResponse {
+    success: boolean;
+    job_id?: string;
+    scheduled_date?: string;
+    title?: string;
+    caption?: string;
+    platform_content?: Record<string, { title: string; caption: string }>;
+    error?: string;
+    error_code?: string;
+    [key: string]: any;
+  }
+
   export interface UserProfile {
     username: string;
     social_accounts?: Record<string, any>;
@@ -1412,18 +1466,7 @@ declare module 'upload-post' {
      * @param jobId - Scheduled job ID
      * @param options - Edit options
      */
-    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 }>;
+    editScheduled(jobId: string, options?: EditScheduledOptions): Promise<EditScheduledResponse>;
 
     // User Management
     /**

package/index.js

@@ -300,9 +300,14 @@ export class UploadPost {
     if (options.instagramCollaborators) form.append('collaborators', options.instagramCollaborators);
     if (options.instagramUserTags) form.append('user_tags', options.instagramUserTags);
     if (options.instagramLocationId) form.append('location_id', options.instagramLocationId);
+    // AI-content label. The API field is the generic is_ai_generated, which other
+    // platforms in the same post also read (it is the same media).
+    this._appendField(form, 'is_ai_generated', this._pick(options, 'instagramIsAiGenerated', 'isAiGenerated', 'is_ai_generated'));
 
     if (isVideo) {
       if (options.instagramShareToFeed !== undefined) form.append('share_to_feed', String(options.instagramShareToFeed));
+      // Trial Reels: TRIAL_REELS_SHARE_TO_FOLLOWERS_IF_LIKED or TRIAL_REELS_DONT_SHARE_TO_FOLLOWERS.
+      this._appendField(form, 'share_mode', this._pick(options, 'instagramShareMode', 'share_mode'));
       if (options.instagramCoverUrl) {
         const coverVal = options.instagramCoverUrl;
         if (typeof coverVal === 'string' && (coverVal.toLowerCase().startsWith('http://') || coverVal.toLowerCase().startsWith('https://'))) {
@@ -426,6 +431,8 @@ export class UploadPost {
 
     if (!isVideo && !isText) {
       this._appendField(form, 'facebook_alt_text', this._pick(options, 'facebookAltText', 'facebook_alt_text'));
+      // POSTS (default) or STORIES for a Page photo story.
+      this._appendField(form, 'facebook_media_type', this._pick(options, 'facebookMediaType', 'facebook_media_type'));
     }
 
     if (isText && options.facebookLinkUrl) {
@@ -1425,9 +1432,20 @@ export class UploadPost {
    * @param {Object} [options.platformContent] - Per-platform text, e.g.
    *   { instagram: { caption: '...' }, tiktok: { caption: '...' }, youtube: { title: '...' } }.
    *   Only the platforms listed are touched.
+   * @param {Object} [options.fields] - Any other editable upload option, keyed by the
+   *   API form name (e.g. { privacyStatus: 'unlisted', tags: '["a","b"]', disable_comment: true,
+   *   instagram_first_comment: '...' }). `null` removes an option. Unknown or internal keys
+   *   are ignored by the API.
+   * @param {string|null} [options.youtubePublishAt] - Native YouTube scheduling (RFC3339),
+   *   sent as fields.youtube_publish_at; `null` removes it. Wins over the same key in `fields`.
+   * @param {string} [options.coverImageBase64] - New cover image (Instagram / Facebook Reels),
+   *   base64 or a data URL
+   * @param {string} [options.coverFilename] - File name of the new cover (default cover.jpg)
+   * @param {string} [options.coverContentType] - MIME type of the new cover (default image/jpeg)
+   * @param {boolean} [options.removeCover] - Remove the custom cover
    * @returns {Promise<Object>} Edit result
    */
-  async editScheduled(jobId, options) {
+  async editScheduled(jobId, options = {}) {
     const body = {};
     if (options.scheduledDate) body.scheduled_date = options.scheduledDate;
     if (options.timezone) body.timezone = options.timezone;
@@ -1435,6 +1453,15 @@ export class UploadPost {
     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;
+    const fields = { ...(options.fields || {}) };
+    if (options.youtubePublishAt !== undefined) fields.youtube_publish_at = options.youtubePublishAt;
+    if (Object.keys(fields).length) body.fields = fields;
+    if (options.removeCover === true) body.remove_cover = true;
+    else if (options.coverImageBase64) {
+      body.cover_image_base64 = options.coverImageBase64;
+      if (options.coverFilename) body.cover_filename = options.coverFilename;
+      if (options.coverContentType) body.cover_content_type = options.coverContentType;
+    }
     return this._request(`/uploadposts/schedule/${jobId}`, 'PATCH', body);
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "upload-post",
-  "version": "2.15.0",
+  "version": "2.17.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",