How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Benchling Containers API

Containers are the backbone of sample management in Benchling. They represent physical containers, such as tubes or wells, that hold quantities of biological samples (represented by the entities inside the container). The container itself tracks its total volume, and the concentration of every entity inside of it.Containers are all associated with schemas, which define the type of the container (e.g. "Tube") along with the fields that are tracked.Like all inventory, every container has a barcode that is unique across the registry.

Benchling Containers API is one of 58 APIs that Benchling publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Containers. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, a changelog, and a status page.

This API exposes 19 operations across 15 paths, and defines 90 schemas. It is described by OpenAPI 3.0.1, at version 2.0.0.

Requests are made against a single base URL, /api/v2.

19 operations 15 paths 90 schemas 1 DELETE5 GET2 PATCH11 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
2.0.0
Base URL
https://{tenant}.benchling.com/api/v2
Authentication
HTTP Basic, HTTP Basic, OAuth 2.0
License
Resource Areas
1

Authentication & Security 3

Benchling Containers API declares 3 security schemes for authenticating requests. It accepts HTTP basic authentication (basicApiKeyAuth). It accepts HTTP basic authentication (basicClientIdSecretAuth). It supports OAuth 2.0 (oAuth) using the clientCredentials flow. By default, every request must be authenticated.

  • basicApiKeyAuth — Use issued API key for standard access to the API
  • basicClientIdSecretAuth — Auth used as part of client credentials OAuth flow prior to receiving a bearer token.
  • oAuth — OAuth2 Client Credentials flow intended for service access

Paths & Operations 19

Across 15 paths, the API surfaces 19 operations — 1 DELETE, 5 GET, 2 PATCH, 11 POST. Each is listed below with its method, path, parameters, and response codes.

Containers 19

Containers are the backbone of sample management in Benchling. They represent physical containers, such as tubes or wells, that hold quantities of biological samples (represented…

GET
/containers
List containers
listContainers 28 params → 200400
POST
/containers
Create a new container
createContainer body → 201400
GET
/containers/{container_id}
get a container by id
getContainer 2 params → 200400404
PATCH
/containers/{container_id}
update a container
updateContainer 1 param body → 200400403404
GET
/containers/{container_id}/contents
List a container's contents
listContainerContents 1 param → 200400404
DELETE
/containers/{container_id}/contents/{containable_id}
Delete a container content
deleteContainerContent 2 params → 204403404
GET
/containers/{container_id}/contents/{containable_id}
Get a container content
getContainerContent 2 params → 200400404
PATCH
/containers/{container_id}/contents/{containable_id}
Update a container content
updateContainerContent 2 params body → 200400403404
POST
/containers/{destination_container_id}:transfer
Transfer into container
transferIntoContainer 1 param body → 200400403
POST
/containers:archive
Archive containers
archiveContainers body → 200400403
POST
/containers:bulk-create
Bulk create containers. Limit of 1000 containers per request.
bulkCreateContainers body → 202400
GET
/containers:bulk-get
Bulk get a set of containers
bulkGetContainers 3 params → 200400
POST
/containers:bulk-update
Bulk update containers
bulkUpdateContainers body → 202400
POST
/containers:check-in
Check in containers
checkinContainers body → 200400403
POST
/containers:check-out
Check out containers
checkoutContainers body → 200400403
POST
/containers:print-labels
Print labels
printLabels body → 200400
POST
/containers:reserve
Reserve containers
reserveContainers body → 200400403
POST
/containers:unarchive
Unarchive containers
unarchiveContainers body → 200400
POST
/transfers
Transfers into containers
transferIntoContainers body → 202400

Schemas 90

The contract defines 90 schemas that model the data the API accepts and returns. The most detailed are RnaSequence (29 properties), DnaSequence (27 properties), Container (21 properties), Mixture (21 properties). Each schema is shown below with its type and property counts.

Primer
object
9 properties
DeprecatedContainerVolumeForResponse
ExperimentalWellRole
object
3 properties
ContainerBulkUpdateItem
ArchiveRecord
object
1 property
FieldType
string
MixtureWithEntityType
object
PrintLabels
object
3 properties 3 required
ContainerLabels
object
3 properties
AaSequenceSummary
object
3 properties
DnaSequenceTranscription
object
4 properties
Batch
object
11 properties
RnaSequenceWithEntityType
object
ContainersArchive
object
3 properties 2 required
NotFoundError
object
1 property
MixtureMeasurementUnits
string
Container
object
21 properties
AaSequence
object
21 properties
CustomEntity
object
18 properties
RnaOligoWithEntityType
object
TeamSummary
AaSequenceWithEntityType
object
RnaSequencePart
ContainerTransferDestinationContentsItem
object
2 properties 1 required
ContainerTransferBase
object
8 properties
CustomEntityWithEntityType
object
CustomField
object
1 property
EmptyObject
object
EntityOrInaccessibleResource
object
SequenceFeatureCustomField
object
A name and value pair associated with a sequence feature (annotation or translation). For genbank imports, these are the qualifiers associated with each featur…
2 properties
Entity
object
SampleRestrictionStatus
string
AaAnnotation
object
7 properties
SequenceFeatureBase
object
4 properties
SchemaFieldsQueryParam
object
MultipleContainersTransfersList
object
1 property 1 required
IngredientMeasurementUnits
string
CustomEntitySummary
object
3 properties
ContainerUpdate
AsyncTaskLink
object
1 property
RnaSequence
object
29 properties
DeprecatedContainerVolumeForInput
object
Desired volume for a container, well, or transfer. "volume" type keys are deprecated in API requests; use the more permissive "quantity" type key instead.
2 properties
RnaAnnotation
ContainerContent
object
3 properties
DnaSequence
object
27 properties
ContainerCreate
SchemaSummary
object
2 properties
Molecule
object
19 properties
DnaSequenceWithEntityType
object
ContainerQuantity
object
Quantity of a container, well, or transfer. Supports mass, volume, and other quantities.
2 properties
Fields
object
ContainersBulkCreateRequest
object
1 property 1 required
Measurement
object
2 properties 2 required
ContainersList
object
1 property
NucleotideSequencePart
object
3 properties
DnaOligoWithEntityType
object
ContainersBulkUpdateRequest
object
1 property 1 required
BaseError
object
3 properties
RnaOligo
MoleculeWithEntityType
object
ContainersArchivalChange
object
IDs of all items that were unarchived, grouped by resource type. This includes the IDs of containers that were unarchived.
1 property
ContainersCheckin
object
2 properties 1 required
PartySummary
object
3 properties
ContainerContentsList
object
1 property
DnaSequencePart
CheckoutRecord
object
assignee field is set if status is "RESERVED" or "CHECKEDOUT", or null if status is "AVAILABLE". comment field is set when container was last reserved, checked…
4 properties
CustomFields
object
ContainerWriteBase
object
6 properties
ContainersUnarchive
object
1 property 1 required
ContainersPaginatedList
InaccessibleResource
object
3 properties
ContainerTransfer
object
ForbiddenRestrictedSampleError
object
1 property
EntityLabels
object
3 properties
ContainersCheckout
object
3 properties 2 required
BadRequestError
object
1 property
DnaAnnotation
Pagination
object
1 property
DnaOligo
ContainerContentUpdate
object
1 property 1 required
MultipleContainersTransfer
object
UserSummary
Mixture
object
21 properties
DnaSequenceSummary
object
3 properties
Translation
Field
object
5 properties 1 required
BatchOrInaccessibleResource
Oligo
object
20 properties
RegistrationOrigin
object
2 properties
Ingredient
object
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

benchling-containers-api-openapi.yml Raw ↑

Other APIs Benchling publishes across the network.

Benchling AA Sequences API
Benchling Apps API
Benchling Assay Results API
Benchling Assay Runs API
Benchling Audit API
Benchling Authentication API
Benchling Blobs API
Benchling Boxes API
Benchling Codon Usage Tables API
Benchling Connect API
Benchling Custom Entities API
Benchling Custom Notations API
Where this information came from

This is an independent, third-party profile of Benchling Containers API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.