/api/v1/files/uploads/batchStart many file uploads
Opens an upload for each of up to 50 files in one call. Each file is checked on its own, exactly as Start a file upload: a file that can't be uploaded comes back with ok: false, its error and status, and the others are opened. With short_links: true every part also gets a short_url (upload one part). resumed: true means an open upload for the same file was handed back: ask Check an upload which parts it already holds.
Request body
#application/json, required
filesarray of objectRequired1–50 items.
11 fields inside
file_namestringRequiredThe file's name, with its extension. 1–255 characters.
size_bytesintegerRequiredThe file's exact size in bytes. At least 1.
content_typestringUp to 255 characters. Default
"".sha256stringRequiredThe SHA-256 of the whole file, in hex. The server checks it before the file goes live. Matches
^[0-9a-fA-F]{64}$.target_slugstringReplace the file behind this existing address instead of publishing a new one. The link, access and views stay. Matches
^[A-Za-z0-9_-]{1,64}$.titlestringShown on the page and in link previews. Up to 200 characters.
access"link" | "private" | "password" | "workspace"Who can open it:
link,private,password(needspassword) orworkspace(needsworkspace).passwordstring1–100 characters.
workspacestringFile it in this workspace: the workspace's id. 1–64 characters.
folderstringAn existing folder of
workspace: its id or its path, likeguides/setup. 1–400 characters.slugstringYour own address:
markdrop.in/<slug>. 3–50 characters. Matches^[a-zA-Z0-9_-]+$.
short_linksbooleanDefault
false.
Responses
#200OK.401No token, or the token is revoked or mistyped.422The request didn't validate.detaillists each problem, with where it is (loc) and why (msg).429Too many requests from your IP address. Wait the seconds inRetry-After.
200 response: 1 field (UploadBatchCreateResponse)
uploadsarray of object11 fields inside
indexintegerokbooleanfile_namestringupload_idstring | nullpart_sizeinteger | nullpart_countinteger | nullpartsarray of object | nullexpires_atstring (date-time) | nullISO 8601, for example
2026-11-30T12:00:00Z.resumedbooleanDefault
false.errorstring | nullstatusinteger | null