POST/api/v1/files/uploads/batch

Start 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.

API token required10 per minute per IPMCP: create_uploadsCLI: markdrop upload
Code samples and Try it

Request body

#

application/json, required

  • filesarray of objectRequired

    1–50 items.

    11 fields inside
    • file_namestringRequired

      The file's name, with its extension. 1–255 characters.

    • size_bytesintegerRequired

      The file's exact size in bytes. At least 1.

    • content_typestring

      Up to 255 characters. Default "".

    • sha256stringRequired

      The SHA-256 of the whole file, in hex. The server checks it before the file goes live. Matches ^[0-9a-fA-F]{64}$.

    • target_slugstring

      Replace 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}$.

    • titlestring

      Shown on the page and in link previews. Up to 200 characters.

    • access"link" | "private" | "password" | "workspace"

      Who can open it: link, private, password (needs password) or workspace (needs workspace).

    • passwordstring

      1–100 characters.

    • workspacestring

      File it in this workspace: the workspace's id. 1–64 characters.

    • folderstring

      An existing folder of workspace: its id or its path, like guides/setup. 1–400 characters.

    • slugstring

      Your own address: markdrop.in/<slug>. 3–50 characters. Matches ^[a-zA-Z0-9_-]+$.

  • short_linksboolean

    Default false.

Responses

#
  • 200OK.
  • 401No token, or the token is revoked or mistyped.
  • 422The request didn't validate. detail lists each problem, with where it is (loc) and why (msg).
  • 429Too many requests from your IP address. Wait the seconds in Retry-After.
200 response: 1 field (UploadBatchCreateResponse)
  • uploadsarray of object
    11 fields inside
    • indexinteger
    • okboolean
    • file_namestring
    • upload_idstring | null
    • part_sizeinteger | null
    • part_countinteger | null
    • partsarray of object | null
    • expires_atstring (date-time) | null

      ISO 8601, for example 2026-11-30T12:00:00Z.

    • resumedboolean

      Default false.

    • errorstring | null
    • statusinteger | null
Did this page help?