---
title: "Bulk create containers. Limit of 1000 containers per request."
method: POST
path: "/containers:bulk-create"
tags: ["containers"]
---

# Bulk create containers. Limit of 1000 containers per request.

`POST /containers:bulk-create`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2`
- URL: `https://{tenant_name}.benchling.com/api/v2/containers:bulk-create`
- Auth: HTTP bearer

Bulk create containers

## Request body

- ContainersBulkCreateRequest
  - `containers` ContainerCreate[], required
    - `fields` Fields
    - `name` string
    - `parentStorageId` string: ID of containing parent inventory, can also specify a coordinate for plates and boxes (e.g. plt_2bAks9dx:a2).
    - `restrictedSamplePartyIds` string[]: IDs of users or teams who have access to use a restricted container. Well plate wells and unrestricted containers do not have restricted sample parties.
    - `restrictionStatus` 'RESTRICTED' | 'UNRESTRICTED' | 'NOT_APPLICABLE'
    - `sampleOwnerIds` string[]: IDs of users or teams who are sample owners for the container. Well plate wells do not have sample owners.
    - `barcode` string
    - `projectId` string, nullable
    - `schemaId` string, required

## Response `202`

This endpoint launches a [long-running task](https://docs.benchling.com/docs/api/v2/benchling-api/tasks/get-task) and returns the Task ID of the launched task.
The task response contains the full list of Containers that were created.

- AsyncTaskLink
  - `taskId` string

## 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)