BEbenchling
blobs

Initiate multi-part blob upload

Blobs may be uploaded using multi-part upload. This endpoint initiates the upload process - blob parts can then be uploaded in multiple blob parts.

Multipart Upload

If a blob is larger than 10MB, it should be uploaded in multiple parts using the following endpoints:

Each part must be at least 5MB in size, except for the last part. We recommend keeping each part to under 10MB when uploading.

Each part has a partNumber and an eTag. The part number can be any number between 1 to 10,000, inclusive - this number should be unique and identifies the order of the part in the final blob. The eTag of a part is returned in the API response - this eTag must be specified when completing the upload in order to ensure the server has received all the expected parts.

post/blobs:start-multipart-upload

Request

  • Base URL
    https://{tenant_name}.benchling.com/api/v2
  • Auth
    HTTP bearer

Request body

mimeTypestring

eg. application/jpeg

namestring required

Name of the blob

type'RAW_FILE' | 'VISUALIZATION' required

One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.

Response

Created

idstring uuid

The universally unique identifier (UUID) for the blob.

mimeTypestring

eg. application/jpeg

namestring

Name of the blob

type'RAW_FILE' | 'VISUALIZATION'

One of RAW_FILE or VISUALIZATION. If VISUALIZATION, the blob may be displayed as an image preview.

uploadStatus'IN_PROGRESS' | 'COMPLETE' | 'ABORTED'

Changes

No recorded changes to this operation across all 1 revision of this API.