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_
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. |
JSON Schema
{
"$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.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/json-schemas/multi-upload-tool-com-upload-request"
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.