# Benchling Container Schema API

**Canonical:** https://apis.io/apis/benchling/benchling-containerschema-api/  
**Provider:** Benchling — https://apis.io/providers/benchling/  
**Base URL:** https://{tenant}.benchling.com/api/v2  
**Documentation:** https://docs.benchling.com/docs/developer-platform-overview

Benchling Container Schema API is one of 203 APIs that [Benchling](https://apis.io/providers/benchling/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include ContainerSchema. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, rate-limit docs, and a changelog.

Defines the structure and metadata for a category of Containers in Benchling's inventory system. A `ContainerSchema` specifies the container type (e.g., "1.5mL Microcentrifuge Tube", "2mL Cryovial"), custom field definitions for capturing container-specific data, and an optional Registry association with display ID prefix. `ContainerSchema`s are referenced by box and matrix plate schemas to constrain what container types can be stored in boxes or plates of that type, and by fixed plate schemas to identify the container schema for the wells, which are modeled as containers. Examples of container schemas include "Eppendorf Tube", "Falcon Tube", or custom organization-specific container types.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| POST | `/container-schema` | Create ContainerSchema |
| GET | `/container-schema/items` | List ContainerSchema items |
| GET | `/container-schema/{container_schema_id}` | Get ContainerSchema by ID |
| PATCH | `/container-schema/{container_schema_id}` | Update ContainerSchema |
| GET | `/container-schema/{container_schema_id}/field-definitions/items` | List SchemaFieldDefinition items |
| POST | `/container-schema:batch-create` | Batch create ContainerSchema |
| PATCH | `/container-schema:batch-update` | Batch update ContainerSchema |
| POST | `/container-schema:bulk-create` | Bulk create ContainerSchema |
| PATCH | `/container-schema:bulk-update` | Bulk update ContainerSchema |

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/openapi/benchling-containerschema-api-openapi.yml
- **OpenAPIRemote** — https://benchling.com/api/v3/openapi.yaml
- **Documentation** — https://docs.benchling.com/docs/developer-platform-overview
- **APIReference** — https://benchling.com/api/v3/reference
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/authentication/benchling-authentication.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/scopes/benchling-scopes.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/conventions/benchling-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/errors/benchling-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/data-model/benchling-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/asyncapi/benchling-webhooks.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/rate-limits/benchling-rate-limits.yml
- **Lifecycle** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/lifecycle/benchling-lifecycle.yml
- **ChangeLog** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/changelog/benchling-changelog.yml
- **StabilityPolicy** — https://docs.benchling.com/docs/stability-guidelines
- **SDKs** — https://raw.githubusercontent.com/api-evangelist/benchling/refs/heads/main/packages/benchling-packages.yml

## Other Benchling APIs (12)

- [Benchling AA Sequences API](https://apis.io/apis/benchling/benchling-aa-sequences-api/)
- [Benchling Apps API](https://apis.io/apis/benchling/benchling-apps-api/)
- [Benchling Assay Results API](https://apis.io/apis/benchling/benchling-assay-results-api/)
- [Benchling Assay Runs API](https://apis.io/apis/benchling/benchling-assay-runs-api/)
- [Benchling Audit API](https://apis.io/apis/benchling/benchling-audit-api/)
- [Benchling Authentication API](https://apis.io/apis/benchling/benchling-authentication-api/)
- [Benchling Blobs API](https://apis.io/apis/benchling/benchling-blobs-api/)
- [Benchling Boxes API](https://apis.io/apis/benchling/benchling-boxes-api/)
- [Benchling Codon Usage Tables API](https://apis.io/apis/benchling/benchling-codon-usage-tables-api/)
- [Benchling Connect API](https://apis.io/apis/benchling/benchling-connect-api/)
- [Benchling Containers API](https://apis.io/apis/benchling/benchling-containers-api/)
- [Benchling Custom Entities API](https://apis.io/apis/benchling/benchling-custom-entities-api/)

## Tags

ContainerSchema

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/benchling/benchling-containerschema-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/benchling/.