---
title: "Complete multi-part blob upload"
method: POST
path: "/blobs/{blob_id}:complete-upload"
tags: ["blobs"]
---

# Complete multi-part blob upload

`POST /blobs/{blob_id}:complete-upload`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/blobs/{blob_id}:complete-upload`
- Auth: HTTP bearer

Combine blob parts into a single blob.

## Multipart Upload

If a blob is larger than 10MB, it should be uploaded in multiple parts using the following endpoints:
- [Start a multi-part blob upload](https://docs.benchling.com/docs/api/v2/benchling-api/blobs/create-multipart-blob)
- [Upload a blob part](https://docs.benchling.com/docs/api/v2/benchling-api/blobs/create-blob-part)
- [Complete a blob upload](https://docs.benchling.com/docs/api/v2/benchling-api/blobs/complete-multipart-blob)

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.

## Path parameters

- `blob_id` string, required

## Request body

- BlobComplete
  - `parts` BlobPart[]
    - `eTag` string
    - `partNumber` integer

## Response `200`

Created

- Blob
  - `id` string, uuid: The universally unique identifier (UUID) for the blob.
  - `mimeType` string: eg. application/jpeg
  - `name` string: 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'

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-2.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-2/revisions/01d2fa8523cd?raw)