{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/multi-upload-tool-com/json-schema/multi-upload-tool-com-bulk-upload-request-schema.json",
  "title": "BulkUploadRequest",
  "description": "Same options as `UploadRequest`, fanned out across several accounts. At most one X account per batch (X bans identical content across accounts): the extra X accounts get a per-account error. Each platform option only applies to the accounts of that platform, except `media_type`, which applies to every platform of the batch that reads it. `video` must be a file part here (no URL string).",
  "x-generated": "2026-11-18",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/multi-upload-tool-com-openapi.json#/components/schemas/BulkUploadRequest",
  "type": "object",
  "required": [
    "accounts"
  ],
  "properties": {
    "accounts": {
      "description": "Target connected accounts, as an array or a JSON-encoded array string.",
      "oneOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "string"
        }
      ]
    },
    "video": {
      "type": "string",
      "format": "binary"
    },
    "photo": {
      "$ref": "#/$defs/MediaField"
    },
    "title": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "pending_approval"
      ],
      "description": "Create without publishing: a draft, or a post awaiting approval. It is only published once approved (POST /upload/{id}/approve or a client review link). In a team that requires approval, a MEMBER's posts are always `pending_approval`."
    },
    "schedule_date": {
      "type": "string",
      "format": "date-time"
    },
    "overrides": {
      "type": "string",
      "description": "JSON object of per-network or per-account variants: keys are a platform name or an account id of this post, values `{ caption?, title?, thumbnail_url? }`. An account key wins over its platform key, which wins over `description` / `title`, field by field. Each account is validated against its own text. An unknown key returns 400."
    },
    "link": {
      "type": "string",
      "format": "uri",
      "description": "Facebook link posts."
    },
    "privacy_level": {
      "type": "string",
      "description": "TikTok. E.g. `PUBLIC_TO_EVERYONE`, `SELF_ONLY`, `MUTUAL_FOLLOW_FRIENDS`."
    },
    "disable_comment": {
      "type": "boolean",
      "description": "TikTok."
    },
    "disable_duet": {
      "type": "boolean",
      "description": "TikTok."
    },
    "disable_stitch": {
      "type": "boolean",
      "description": "TikTok."
    },
    "brand_content_toggle": {
      "type": "boolean",
      "description": "TikTok: paid partnership disclosure."
    },
    "brand_organic_toggle": {
      "type": "boolean",
      "description": "TikTok: own-brand disclosure."
    },
    "is_aigc": {
      "type": "boolean",
      "description": "TikTok: content is AI-generated."
    },
    "post_mode": {
      "type": "string",
      "enum": [
        "DIRECT_POST",
        "MEDIA_UPLOAD"
      ],
      "description": "TikTok. `DIRECT_POST` (default) publishes. `MEDIA_UPLOAD` sends the post to the creator's TikTok inbox instead, where they finish and publish it in the app; TikTok allows at most 5 pending inbox posts per 24 hours."
    },
    "media_type": {
      "type": "string",
      "description": "TikTok: video or photo carousel. Instagram: `REELS`, `IMAGE`, `CAROUSEL` or `STORIES`, auto-detected when omitted.\n\n`STORIES` publishes to the account's story instead of the feed. It takes exactly one media — a JPEG image up to 8 MB (PNG is refused), or an MP4/MOV video of 3 to 60 seconds up to 100 MB — and nothing else: `collaborators` and `location_id` are refused, the caption is dropped because stories have none, and the AI label is not sent because the API has no such field on stories. A story expires after 24 hours, has no permanent URL and no analytics."
    },
    "video_cover_timestamp_ms": {
      "type": "integer",
      "description": "TikTok: cover frame offset."
    },
    "auto_add_music": {
      "type": "boolean",
      "description": "TikTok photo posts."
    },
    "photo_cover_index": {
      "type": "integer",
      "description": "TikTok photo posts."
    },
    "youtube_title": {
      "type": "string",
      "description": "YouTube: overrides `title`."
    },
    "youtube_description": {
      "type": "string",
      "description": "YouTube: overrides `description`."
    },
    "tags": {
      "description": "YouTube tags. Comma-separated string or array. The platform caps the serialised list at 500 characters.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      ]
    },
    "categoryId": {
      "type": "string",
      "description": "YouTube category id."
    },
    "privacyStatus": {
      "type": "string",
      "description": "YouTube. `public`, `private` or `unlisted`."
    },
    "thumbnail": {
      "type": "string",
      "format": "binary",
      "description": "YouTube custom thumbnail."
    },
    "thumbnail_url": {
      "type": "string",
      "format": "uri",
      "description": "YouTube custom thumbnail by URL."
    },
    "scheduledDate": {
      "type": "string",
      "format": "date-time",
      "description": "YouTube publication time."
    },
    "embeddable": {
      "type": "boolean",
      "description": "YouTube."
    },
    "license": {
      "type": "string",
      "description": "YouTube."
    },
    "publicStatsViewable": {
      "type": "boolean",
      "description": "YouTube."
    },
    "madeForKids": {
      "type": "boolean",
      "description": "YouTube."
    },
    "selfDeclaredMadeForKids": {
      "type": "boolean",
      "description": "YouTube."
    },
    "containsSyntheticMedia": {
      "type": "boolean",
      "description": "YouTube: altered or synthetic content disclosure."
    },
    "defaultLanguage": {
      "type": "string",
      "description": "YouTube."
    },
    "defaultAudioLanguage": {
      "type": "string",
      "description": "YouTube."
    },
    "allowedCountries": {
      "type": "string",
      "description": "YouTube: comma-separated country allowlist."
    },
    "blockedCountries": {
      "type": "string",
      "description": "YouTube: comma-separated country blocklist."
    },
    "hasPaidProductPlacement": {
      "type": "boolean",
      "description": "YouTube."
    },
    "recordingDate": {
      "type": "string",
      "format": "date-time",
      "description": "YouTube."
    },
    "notifySubscribers": {
      "type": "boolean",
      "description": "YouTube."
    },
    "caption": {
      "type": "string",
      "description": "Instagram: overrides `description`."
    },
    "cover_url": {
      "type": "string",
      "format": "uri",
      "description": "Instagram Reels cover."
    },
    "collaborators": {
      "type": "string",
      "description": "Instagram: comma-separated usernames."
    },
    "user_tags": {
      "type": "string",
      "description": "Instagram."
    },
    "location_id": {
      "type": "string",
      "description": "Instagram. Not accepted on a story."
    },
    "share_to_feed": {
      "type": "boolean",
      "description": "Instagram Reels: also show the Reel in the feed. Default `true`."
    },
    "trial_reel": {
      "type": "string",
      "enum": [
        "manual",
        "auto"
      ],
      "description": "Instagram Trial Reel: shown to non-followers first. `manual` = the creator graduates it to followers in the Instagram app, `auto` = Instagram graduates it if it performs well. Single-video Reels only: a photo, carousel or story with `trial_reel` is refused (400) rather than published to followers. The account must be eligible for Trial Reels."
    },
    "audio_name": {
      "type": "string",
      "description": "Instagram Reels: display title of the Reel's original audio."
    },
    "thumb_offset": {
      "type": "string",
      "description": "Instagram Reels: cover frame offset, in ms."
    },
    "threads_reply_control": {
      "type": "string",
      "enum": [
        "everyone",
        "accounts_you_follow",
        "mentioned_only",
        "parent_post_author_only",
        "followers_only"
      ],
      "description": "Threads: who can reply. Default `everyone`."
    },
    "threads_alt_text": {
      "type": "string",
      "maxLength": 1000,
      "description": "Threads: image alt text."
    },
    "x_reply_settings": {
      "type": "string",
      "enum": [
        "everyone",
        "following",
        "mentionedUsers",
        "subscribers",
        "verified"
      ],
      "description": "X: who can reply. Default `everyone`."
    },
    "x_made_with_ai": {
      "type": "boolean",
      "description": "X: label the post as made with AI."
    },
    "x_paid_partnership": {
      "type": "boolean",
      "description": "X: label the post as a paid partnership."
    },
    "x_alt_text": {
      "type": "string",
      "maxLength": 1000,
      "description": "X: alt text applied to every image. Images only."
    },
    "x_tagged_users": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "pattern": "^@?\\w{1,15}$"
      },
      "description": "X: usernames tagged in the photos (multipart: JSON array or comma-separated). Images only. A tag only shows if the person allows photo tagging."
    },
    "x_subtitles_url": {
      "type": "string",
      "format": "uri",
      "description": "X: SRT or VTT file (max 1 MB) shown as captions. Video only."
    },
    "x_subtitles_language": {
      "type": "string",
      "pattern": "^[a-zA-Z]{2}$",
      "description": "X: 2-letter language code of the subtitles. Default `EN`. Needs `x_subtitles_url`."
    },
    "x_poll_options": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 25
      },
      "description": "X: poll choices (multipart: JSON array or comma-separated). Text-only posts: X refuses a poll with media."
    },
    "x_poll_duration_minutes": {
      "type": "integer",
      "minimum": 5,
      "maximum": 10080,
      "description": "X: poll duration. Default `1440`. Needs `x_poll_options`."
    },
    "x_community_id": {
      "type": "string",
      "pattern": "^[0-9]{1,19}$",
      "description": "X: post to this Community."
    },
    "x_share_with_followers": {
      "type": "boolean",
      "description": "X: with `x_community_id`, also show the post to followers."
    },
    "x_super_followers_only": {
      "type": "boolean",
      "description": "X: only Super Followers see the post. The account needs X subscriptions enabled."
    },
    "x_premium": {
      "type": "boolean",
      "description": "X: the account has X Premium, so text up to 25,000 characters instead of 280 and videos up to 125 minutes instead of 20."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "PUBLIC",
        "CONNECTIONS"
      ],
      "description": "LinkedIn."
    },
    "bluesky_langs": {
      "type": "string",
      "description": "Bluesky: comma-separated language codes (e.g. `en,fr`) or a JSON array."
    },
    "bluesky_labels": {
      "type": "string",
      "description": "Bluesky content warnings: `sexual`, `nudity`, `porn`, `graphic-media`, `!no-unauthenticated`."
    },
    "pinterest_board_id": {
      "type": "string",
      "description": "Pinterest: board to pin to."
    },
    "board_id": {
      "type": "string",
      "description": "Pinterest: alias of `pinterest_board_id`."
    },
    "instagram_as_story": {
      "type": "boolean",
      "description": "Publish to the story of the Instagram accounts in the batch, with the rules of `media_type: STORIES` on `UploadRequest`. A separate switch because `media_type` applies to every platform of the batch and cannot mean \"story\" for Instagram alone; the other platforms publish normally."
    }
  },
  "$defs": {
    "MediaField": {
      "description": "A file part, a publicly reachable URL, or an array of either. File parts must stay under the 100 MB edge cap on the request body; larger media is sent as the `accessUrl` returned by `POST /upload/presign`.",
      "oneOf": [
        {
          "type": "string",
          "format": "binary"
        },
        {
          "type": "string",
          "format": "uri"
        },
        {
          "type": "array",
          "items": {
            "oneOf": [
              {
                "type": "string",
                "format": "binary"
              },
              {
                "type": "string",
                "format": "uri"
              }
            ]
          }
        }
      ]
    }
  }
}