bus

Create a multipart upload

Changed on

Creates a new multipart upload and returns an upload ID.

post/bus/multipart/create

Request

  • The document declares no server URL.
  • Auth
    none declared

Request body

bucketstring

The name of the bucket.

keystring

The key of the object to upload

mimeTypestring

The MIME type of the object

metadataObjectUserMetadata

User-defined metadata about an object provided through X-Sia-Meta- headers

disableClientSideEncryptionboolean

Whether to disable client-side encryption

Example request

{
  "bucket": "default",
  "key": "folder/file",
  "mimeType": "text/plain"
}

Response

Successfully created multipart upload

uploadIDstring byte

The ID of the multipart upload

Example response

{
  "uploadID": "f1e2d3c4b5a697887776665544332211ffeeddccbbaa99887766554433221100"
}

Changes

  • c38282599c5aRevision changes
    • breaking

      added subschema #2 to the request property allOf list

    • breaking

      the request property type changed from string to no type

    • info

      the request property's minLength was decreased from 1 to 0

  • 922f156353c9Revision changes
    • breaking

      removed the media type text/plain for the response with the status

    • info

      api tag bus added