---
title: "Transfer into container"
method: POST
path: "/containers/{destination_container_id}:transfer"
tags: ["containers"]
---

# Transfer into container

`POST /containers/{destination_container_id}:transfer`

## Request

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

Transfers a volume of an entity or container into a destination container.
Transfering a volume is cumulative with the existing destination container's contents. To transfer an entire container's contents, the sourceContainerId should be specified. To otherwise transfer multiple entities within a container, you can make multiple calls to this endpoint, specifying a single entity with each call.

## Path parameters

- `destination_container_id` string, required

## Request body

- ContainerTransfer
  - `restrictedSamplePartyIds` string[]: IDs of users or teams to be set as restricted sample parties for the destination container. If not specified, restricted sample parties from the source container, if present, will be added to those of the destination container. This only applies to stand-alone containers.
  - `restrictionStatus` 'RESTRICTED' | 'UNRESTRICTED' | 'NOT_APPLICABLE'
  - `sampleOwnerIds` string[]: IDs of users or teams to be set as sample owners for the destination container. If not specified, restricted sample parties from the source container, if present, will be added to those of the destination container. This only applies to stand-alone containers.
  - `sourceBatchId` string: ID of the batch that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
  - `sourceContainerId` string: ID of the container that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
  - `sourceEntityId` string: ID of the entity that will be transferred in. Must specify one of sourceEntityId, sourceBatchId, or sourceContainerId.
  - `transferQuantity` ContainerQuantity: Quantity of a container, well, or transfer. Supports mass, volume, and other quantities.
    - `units` 'L' | 'mL' | 'uL' | 'nL' | 'pL' | 'gal (US)' | 'qt (US)' | 'pt (US)' | 'kg' | 'g' | 'mg' | 'ug' | 'ng' | 'pg' | 'lb' | 'oz' | 'mol' | 'mmol' | 'umol' | 'nmol' | 'pmol' | 'cells' | '(x10^3) cells' | '(x10^4) cells' | '(x10^5) cells' | '(x10^6) cells' | '(x10^7) cells' | '(x10^8) cells' | '(x10^9) cells' | 'items' | 'units'
    - `value` number, double, nullable
  - `transferVolume` DeprecatedContainerVolumeForInput: Desired volume for a container, well, or transfer. "volume" type keys are deprecated in API requests; use the more permissive "quantity" type key instead.
    - `units` 'pL' | 'nL' | 'uL' | 'mL' | 'L'
    - `value` number, double, nullable
  - `destinationContents` ContainerTransferDestinationContentsItem[], required: This represents what the contents of the destination container should look like post-transfer.
    - `concentration` Measurement
      - `units` string, nullable, required: Can only be null if value is also null
      - `value` number, double, nullable, required: Can only be null if units is also null
    - `entityId` string, required
  - `destinationQuantity` ContainerQuantity: Quantity of a container, well, or transfer. Supports mass, volume, and other quantities.
    - `units` 'L' | 'mL' | 'uL' | 'nL' | 'pL' | 'gal (US)' | 'qt (US)' | 'pt (US)' | 'kg' | 'g' | 'mg' | 'ug' | 'ng' | 'pg' | 'lb' | 'oz' | 'mol' | 'mmol' | 'umol' | 'nmol' | 'pmol' | 'cells' | '(x10^3) cells' | '(x10^4) cells' | '(x10^5) cells' | '(x10^6) cells' | '(x10^7) cells' | '(x10^8) cells' | '(x10^9) cells' | 'items' | 'units'
    - `value` number, double, nullable
  - `destinationVolume` DeprecatedContainerVolumeForInput: Desired volume for a container, well, or transfer. "volume" type keys are deprecated in API requests; use the more permissive "quantity" type key instead.
    - `units` 'pL' | 'nL' | 'uL' | 'mL' | 'L'
    - `value` number, double, nullable

## Response `200`

OK

- EmptyObject

## Other responses

- `400`: Bad Request
- `403`: Forbidden

---

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