Multi Upload Tool · Schema

UploadRequest

Media may be supplied as a file part or as a publicly reachable URL string in the same field. Fields belonging to other platforms are ignored, except an unknown `x_*` field, refused (400) with `x_: `. X: the post fails (X credits refunded) when the same text (case, spaces, punctuation and emoji ignored; captions of 20+ letters or digits) or the exact same media file (SHA-256) was posted on another X account of the same owner in the last 30 days, because X's developer policy bans identical content across accounts.

video publishingSocial Media SchedulingBulk UploadAnalytics

Properties

Name Type Description
accountId object Target connected account.
video object
photo object
file object
title string
description string
status string 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 po
schedule_date string Publish at this time instead of immediately (TikTok, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads).
link string Facebook link posts.
privacy_level string TikTok. E.g. `PUBLIC_TO_EVERYONE`, `SELF_ONLY`, `MUTUAL_FOLLOW_FRIENDS`.
disable_comment boolean TikTok.
disable_duet boolean TikTok.
disable_stitch boolean TikTok.
brand_content_toggle boolean TikTok: paid partnership disclosure.
brand_organic_toggle boolean TikTok: own-brand disclosure.
is_aigc boolean TikTok: content is AI-generated.
post_mode string 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
media_type string TikTok: video or photo carousel. Instagram: `REELS`, `IMAGE`, `CAROUSEL` or `STORIES`, auto-detected when omitted. `STORIES` publishes to the account's story instead of the feed. It takes exactly one
video_cover_timestamp_ms integer TikTok: cover frame offset.
auto_add_music boolean TikTok photo posts.
photo_cover_index integer TikTok photo posts.
youtube_title string YouTube: overrides `title`.
youtube_description string YouTube: overrides `description`.
tags object YouTube tags. Comma-separated string or array. The platform caps the serialised list at 500 characters.
categoryId string YouTube category id.
privacyStatus string YouTube. `public`, `private` or `unlisted`.
thumbnail string YouTube custom thumbnail.
thumbnail_url string YouTube custom thumbnail by URL.
scheduledDate string YouTube publication time.
embeddable boolean YouTube.
license string YouTube.
publicStatsViewable boolean YouTube.
madeForKids boolean YouTube.
selfDeclaredMadeForKids boolean YouTube.
containsSyntheticMedia boolean YouTube: altered or synthetic content disclosure.
defaultLanguage string YouTube.
defaultAudioLanguage string YouTube.
allowedCountries string YouTube: comma-separated country allowlist.
blockedCountries string YouTube: comma-separated country blocklist.
hasPaidProductPlacement boolean YouTube.
recordingDate string YouTube.
notifySubscribers boolean YouTube.
caption string Instagram: overrides `description`.
cover_url string Instagram Reels cover.
collaborators string Instagram: comma-separated usernames.
user_tags string Instagram.
location_id string Instagram. Not accepted on a story.
share_to_feed boolean Instagram Reels: also show the Reel in the feed. Default `true`.
trial_reel string 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:
audio_name string Instagram Reels: display title of the Reel's original audio.
thumb_offset string Instagram Reels: cover frame offset, in ms.
threads_reply_control string Threads: who can reply. Default `everyone`.
threads_alt_text string Threads: image alt text.
x_reply_settings string X: who can reply. Default `everyone`.
x_made_with_ai boolean X: label the post as made with AI.
x_paid_partnership boolean X: label the post as a paid partnership.
x_alt_text string X: alt text applied to every image. Images only.
x_tagged_users array 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 string X: SRT or VTT file (max 1 MB) shown as captions. Video only.
x_subtitles_language string X: 2-letter language code of the subtitles. Default `EN`. Needs `x_subtitles_url`.
x_poll_options array X: poll choices (multipart: JSON array or comma-separated). Text-only posts: X refuses a poll with media.
x_poll_duration_minutes integer X: poll duration. Default `1440`. Needs `x_poll_options`.
x_community_id string X: post to this Community.
x_share_with_followers boolean X: with `x_community_id`, also show the post to followers.
x_super_followers_only boolean X: only Super Followers see the post. The account needs X subscriptions enabled.
x_premium boolean 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 string LinkedIn.
bluesky_langs string Bluesky: comma-separated language codes (e.g. `en,fr`) or a JSON array.
bluesky_labels string Bluesky content warnings: `sexual`, `nudity`, `porn`, `graphic-media`, `!no-unauthenticated`.
pinterest_board_id string Pinterest: board to pin to.
board_id string Pinterest: alias of `pinterest_board_id`.
alt_text string Pinterest: image alt text. On `POST /upload`, also used for Threads when `threads_alt_text` is absent.
View JSON Schema on GitHub

JSON Schema

multi-upload-tool-com-upload-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/multi-upload-tool-com/json-schema/multi-upload-tool-com-upload-request-schema.json",
  "title": "UploadRequest",
  "description": "Media may be supplied as a file part or as a publicly reachable URL string in the same field. Fields belonging to other platforms are ignored, except an unknown `x_*` field, refused (400) with `x_<field>: <message>`. X: the post fails (X credits refunded) when the same text (case, spaces, punctuation and emoji ignored; captions of 20+ letters or digits) or the exact same media file (SHA-256) was posted on another X account of the same owner in the last 30 days, because X's developer policy bans identical content across accounts.",
  "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/UploadRequest",
  "type": "object",
  "required": [
    "accountId"
  ],
  "properties": {
    "accountId": {
      "description": "Target connected account.",
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "integer"
        }
      ]
    },
    "video": {
      "$ref": "#/$defs/MediaField"
    },
    "photo": {
      "$ref": "#/$defs/MediaField"
    },
    "file": {
      "$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",
      "description": "Publish at this time instead of immediately (TikTok, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads)."
    },
    "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`."
    },
    "alt_text": {
      "type": "string",
      "description": "Pinterest: image alt text. On `POST /upload`, also used for Threads when `threads_alt_text` is absent."
    }
  },
  "$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"
              }
            ]
          }
        }
      ]
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/multi-upload-tool-com-upload-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.