Create MatrixPlate

Beta

POST

https://{tenant_name}.benchling.com/api/v3/matrix-plate

POST

/api/v3/matrix-plate

curl -X POST https://{tenant_name}.benchling.com/api/v3/matrix-plate \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "schemaId": "schemaId"
}'

{
  "__typename": "__typename",
  "creator": {
    "__typename": "__typename",
    "id": "id"
  },
  "schemaFields": [
    {
      "__typename": "__typename",
      "id": "id",
      "linkedEntityId": "linkedEntityId"
    }
  ],
  "archiveReason": "archiveReason",
  "archived": true,
  "availableCapacity": 1,
  "barcode": "barcode",
  "createdAt": "createdAt",
  "id": "id",
  "modifiedAt": "modifiedAt",
  "name": "name",
  "occupiedCapacity": 1,
  "parentStorage": {
    "__typename": "__typename",
    "id": "id"
  },
  "positions": [
    {
      "__typename": "__typename"
    }
  ],
  "project": {
    "__typename": "__typename",
    "id": "id"
  },
  "schema": {
    "__typename": "__typename",
    "id": "id"
  },
  "totalCapacity": 1
}

Create MatrixPlate.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

schemaIdstringRequired

barcodestringOptional

Barcode of the plate

containerSchemaIdstringOptional

namestringOptional

Name of the plate; defaults to barcode if name is not provided

parentStorageIdstringOptional

positionslist of objectsOptional

The wells of the plate

projectIdstringOptional

schemaFieldsmap from strings to objectsOptional

Response

Created

__typenamestringOptional

creatorobjectOptional

The user who created the plate

schemaFieldslist of objects or nullOptional

archiveReasonstring or nullOptional

Why the plate is archived

archivedbooleanOptional

Whether the plate is archived

availableCapacityintegerOptional

The number of available positions in a matrix plate.

barcodestring or nullOptional

Barcode of the plate

createdAtstringOptional

DateTime the plate was created

idstringOptional

The ID of the plate.

modifiedAtstringOptional

DateTime the plate was last modified

namestringOptional

Name of the plate; defaults to barcode if name is not provided

occupiedCapacityintegerOptional

The number of containers currently in a matrix plate.

parentStorageobject or nullOptional

Containing parent storage

positionslist of objectsOptional

The wells of the plate

projectobject or nullOptional

The project the plate is associated with

schemaobjectOptional

The schema of the plate

totalCapacityintegerOptional

The total capacity of a matrix plate (i.e. how many containers it can store).

Errors

400

Matrix Plate Create Request Bad Request Error

403

Matrix Plate Create Request Forbidden Error

404

Matrix Plate Create Request Not Found Error

409

Matrix Plate Create Request Conflict Error

429

Matrix Plate Create Request Too Many Requests Error

500

Matrix Plate Create Request Internal Server Error

Authentication

Headers

Request

Response

Errors