---
title: "Batch update PlateRecord"
method: PATCH
path: "/api/v3/plate-record:batch-update"
tags: ["Plate Record"]
---

# Batch update PlateRecord

`PATCH /api/v3/plate-record:batch-update`

## Request

- Base URL: `https://{tenant_name}.benchling.com`
- URL: `https://{tenant_name}.benchling.com/api/v3/plate-record:batch-update`
- Auth: HTTP bearer

Batch update PlateRecord synchronously in one transaction. Maximum 25 items per request.

## Request body

- object
  - `items` UpdatePlateRecordInputWithPathParams[], required
    - `barcode` string: Barcode to record as a plate field in the metadata layer.
    - `concentrationLayers` ConcentrationLayerInput[]
      - `concentrationUnitId` string, required
      - `concentrationUnitVersionNumber` integer, required
      - `name` string, required
      - `wells` ConcentrationWellInput[]
        - `concentrationAmount` number, double, nullable, required
        - `wellPosition` string, required
    - `height` integer
    - `id` string, required
    - `isHidden` boolean: Whether the plate record is hidden from the plate's sidebar list.
    - `metadataLayers` MetadataColumnInput[]
      - `name` string, required
      - `plateValue` union
        - string
        - integer
        - number, double
        - boolean
      - `systemName` string
      - `type` 'text' | 'integer' | 'float' | 'boolean' | 'date' | 'datetime', required
      - `wells` MetadataWellInput[]
        - `value` union, required
          - string
          - integer
          - number, double
          - boolean
        - `wellPosition` string, required
    - `name` string
    - `parameterLayers` ParameterLayerInput[]
      - `fieldType` 'TEXT' | 'FLOAT' | 'DATETIME', required
      - `name` string, required
      - `parameterVersionId` string, required
      - `wells` ParameterWellInput[]
        - `value` union, required
          - string
          - integer
          - number, double
        - `wellPosition` string, required
    - `plateSchemaId` string, nullable
    - `storageId` string: Inventory storage ID to record as a plate field in the metadata layer.
    - `wells` PlateRecordWellInput[]
      - `columnIndex` integer, required
      - `roles` WellRoleInput[]
        - `group` string
        - `role` string, required
        - `subrole` string
      - `rowIndex` integer, required
      - `sampleSchemaId` string
      - `schemaTags` object
      - `wellVolumeAmount` number, double
      - `wellVolumeUnitId` string
      - `wellVolumeUnitVersionNumber` integer
    - `width` integer

## Response `200`

OK

- PlateRecordBatchupdateResponse200
  - `items` PlateRecord[], required
    - `__typename` string
    - `barcode` string, nullable: The plate's barcode, when one has been recorded.
    - `createdAt` string, datetime, nullable
    - `height` integer
    - `id` string
    - `isHidden` boolean: Whether the plate record is hidden from the plate's sidebar list.
    - `layers` PlateRecordLayer[]
      - `__typename` string
      - `dataFrame` DataFrameRef
        - `__typename` string
        - `id` string, api_id
      - `name` string
    - `modifiedAt` string, datetime, nullable
    - `name` string
    - `plateSchema` PlateSchemaInterfaceRef
      - `__typename` string
      - `id` string, api_id
    - `storageId` string, nullable: The plate's storage location identifier, when one has been recorded.
    - `width` integer

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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